> ## 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.

# PFMultiplayerClaimServerLobby

> Référence de PFMultiplayerClaimServerLobby pour revendiquer, en tant que game_server, la propriété d'un lobby PlayFab existant détenu par un serveur, via le SDK C++ PlayFab Multiplayer.

Revendique la propriété d'un lobby de serveur préexistant.

## Syntaxe

```cpp theme={null}
HRESULT PFMultiplayerClaimServerLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* server,  
    const char* lobbyId,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### Paramètres

**`handle`**   PFMultiplayerHandle

Handle de l'instance de l'API PFMultiplayer.

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

Clé d'entité PlayFab du serveur de jeu qui revendique le lobby. Son type d'entité doit être "game\_server".

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

ID du lobby à revendiquer.

**`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 renvoyée

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 via [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md).

## 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. En cas de réussite, le titre reçoit un [PFLobbyClaimServerLobbyCompletedStateChange](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange.md) dont le champ [PFLobbyClaimServerLobbyCompletedStateChange::result](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange.md) est défini sur `S_OK`. En cas d'échec, le titre reçoit un [PFLobbyClaimServerLobbyCompletedStateChange](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange.md) dont le champ [PFLobbyClaimServerLobbyCompletedStateChange::result](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange.md) est défini sur une valeur d'échec.   \
\
 Cette opération est principalement destinée à permettre aux entités game\_server de prendre possession de lobbies détenus par un serveur dont les propriétaires se sont déconnectés ou vont se déconnecter. En général, cela concerne les entités game\_server qui souhaitent transférer la propriété à une autre entité game\_server, ou celles qui doivent récupérer la propriété de leurs propres serveurs après une défaillance irrécupérable leur ayant fait perdre l'accès au handle du lobby, comme un plantage.   \
\
 Un serveur de jeu ne peut pas revendiquer la propriété d'un lobby auquel une autre entité game\_server est actuellement connectée.

## Configuration requise

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

## Voir aussi

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


## Related topics

- [PFLobbyGetLobbyProperty](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyproperty.md)
- [PFLobbyGetLobbyPropertyKeys](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbypropertykeys.md)
- [PFLobbyGetMembers](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md)
- [PFLobbyGetSearchProperty](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchproperty.md)
- [PFLobbyGetSearchPropertyKeys](https://docs.xbox.com/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchpropertykeys.md)