Passer au contenu principal
Rejoint un lobby à l’aide d’une chaîne d’arrangement fournie par un autre service, tel que le matchmaking. Si personne n’a encore rejoint le lobby, celui-ci est initialisé à l’aide des paramètres de configuration.

Syntaxe

Paramètres

handle   PFMultiplayerHandle Handle de l’instance de l’API PFMultiplayer. newMember   PFEntityKey* Entité PlayFab locale qui rejoint le lobby. arrangementString   char*
se termine par un caractère null
Chaîne d’arrangement utilisée par l’entité pour rejoindre le lobby. configuration   PFLobbyArrangedJoinConfiguration* Données de configuration initiales utilisées pour initialiser le lobby, si personne ne l’a encore rejoint. 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 : HRESULT S_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

Il s’agit d’une opération asynchrone. En cas de réussite, le titre reçoit un PFLobbyMemberAddedStateChange suivi d’un PFLobbyJoinArrangedLobbyCompletedStateChange dont le champ PFLobbyJoinArrangedLobbyCompletedStateChange::result est défini sur S_OK. En cas d’échec, le titre reçoit un PFLobbyJoinArrangedLobbyCompletedStateChange dont le champ PFLobbyJoinArrangedLobbyCompletedStateChange::result est défini sur une valeur d’échec.

Lors de l’utilisation du matchmaking au moyen de cette bibliothèque, le PFMatchmakingMatchDetails::lobbyArrangementString peut être utilisé avec cette méthode pour rejoindre un lobby avec tous les utilisateurs qui ont été associés.

Configuration requise

En-tête : PFLobby.h

Voir aussi

Membres de PFLobby
Dernière modification le 8 octobre 2026