Syntaxe
Paramètres
handle PFMultiplayerHandle
Handle de l’instance de l’API PFMultiplayer.
server PFEntityKey*
Clé d’entité PlayFab du serveur qui rejoint le lobby. Son type d’entité doit être “game_server”.
connectionString char*se termine par un caractère null Chaîne de connexion utilisée par le serveur pour rejoindre le lobby.
configuration PFLobbyServerJoinConfiguration*
Données initiales détenues par le serveur à stocker lors de la jonction au lobby.
asyncContext void*facultatif Valeur de contexte facultative, définie par l’application et de la taille d’un pointeur, qui peut être utilisée pour associer le changement d’état d’achèvement à cet appel.
lobby PFLobbyHandle*facultatif, sortie allouée par la bibliothèque Objet lobby facultatif en sortie, qui peut être utilisé pour mettre en file d’attente des opérations à exécuter immédiatement une fois cette opération terminée.
Valeur de retour
Type : HRESULTS_OK si l’appel a réussi, ou un code d’erreur dans le cas contraire. La forme lisible du code d’erreur peut être récupérée au moyen de PFMultiplayerGetErrorMessage().
Remarques
Pour utiliser cette fonctionnalité, vous devez définir PFMULTIPLAYER_INCLUDE_SERVER_APIS avant d’inclure PFLobby.h.Il s’agit d’une opération asynchrone. La fin de l’exécution de cette méthode ne signifie pas nécessairement la fin de l’opération.
En cas de réussite, le titre reçoit un PFLobbyUpdatedStateChange dont le membre PFLobbyUpdatedStateChange::serverUpdate est correctement renseigné, ainsi qu’un PFLobbyJoinLobbyAsServerCompletedStateChange dont le champ PFLobbyJoinLobbyAsServerCompletedStateChange::result est défini sur
S_OK. En cas d’échec, le titre reçoit un PFLobbyJoinLobbyAsServerCompletedStateChange dont le champ PFLobbyJoinLobbyAsServerCompletedStateChange::result est défini sur une valeur d’échec.
Cette opération est réservée aux lobbies détenus par un client qui utilisent des connexions.