> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerJoinLobby

> Référence de PFMultiplayerJoinLobby pour rejoindre un lobby PlayFab existant en tant qu'entité PlayFab locale à l'aide d'une chaîne de connexion dans le SDK C++ Multiplayer.

Rejoint un lobby en tant qu'entité PlayFab locale.

## Syntaxe

```cpp theme={null}
HRESULT PFMultiplayerJoinLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* newMember,  
    const char* connectionString,  
    const PFLobbyJoinConfiguration* configuration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### Paramètres

**`handle`**   PFMultiplayerHandle

Handle de l'instance de l'API PFMultiplayer.

**`newMember`**   [PFEntityKey\*](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)

Entité locale qui rejoint le lobby.

**`connectionString`**   char\*\
*se termine par un caractère null*

Chaîne de connexion utilisée par l'entité pour rejoindre le lobby.

**`configuration`**   [PFLobbyJoinConfiguration\*](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinconfiguration.md)

Données de configuration initiales utilisées 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 : 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()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md).

## Remarques

Il s'agit d'une opération asynchrone. En cas de réussite, le titre reçoit un [PFLobbyMemberAddedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md) suivi d'un [PFLobbyUpdatedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md) et d'un [PFLobbyJoinLobbyCompletedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbycompletedstatechange.md) dont le champ [PFLobbyJoinLobbyCompletedStateChange::result](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbycompletedstatechange.md) est défini sur `S_OK`. En cas d'échec, le titre reçoit un [PFLobbyJoinLobbyCompletedStateChange](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbycompletedstatechange.md) dont le champ [PFLobbyJoinLobbyCompletedStateChange::result](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbycompletedstatechange.md) est défini sur une valeur d'échec.

## Configuration requise

**En-tête :** PFLobby.h

## Voir aussi

[Membres de PFLobby](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [PFLobbyGetLobbyProperty](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyproperty.md)
- [PFLobbyGetLobbyPropertyKeys](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbypropertykeys.md)
- [Intégrer Party à Lobby à l'aide du SDK Multiplayer](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/party-lobby-integration.md)
- [PFLobbyGetMembers](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md)
- [PFLobbyGetMemberProperty](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberproperty.md)