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

# PFMultiplayerClaimServerLobby

> Referencia de PFMultiplayerClaimServerLobby para reclamar la propiedad de un lobby de PlayFab existente propiedad de un servidor como game_server mediante el SDK de C++ de PlayFab Multiplayer.

Reclama la propiedad de un lobby de servidor ya existente.

## Sintaxis

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

### Parámetros

**`handle`**   PFMultiplayerHandle

El identificador de la instancia de la API PFMultiplayer.

**`server`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

La clave de entidad de PlayFab del servidor de juego que reclama el lobby. Su tipo de entidad debe ser "game\_server".

**`lobbyId`**   char\*\
*termina en null*

El identificador del lobby que se va a reclamar.

**`asyncContext`**   void\*\
*opcional*

Un valor de contexto opcional, definido por la aplicación y del tamaño de un puntero, que se puede usar para asociar el cambio de estado de finalización con esta llamada.

**`lobby`**   PFLobbyHandle\*\
*opcional, salida asignada por la biblioteca*

El objeto de lobby de salida opcional, que se puede usar para poner en cola operaciones para su ejecución inmediata cuando se complete esta operación.

### Valor devuelto

Tipo: HRESULT

`S_OK` si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentarios

Para usar esta característica, debe definir PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS antes de incluir PFLobby.h. <br /><br /> Esta es una operación asincrónica. Cuando se completa correctamente, el título recibirá un [PFLobbyClaimServerLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) con el campo [PFLobbyClaimServerLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) establecido en `S_OK`. Si se completa con errores, el título recibirá un [PFLobbyClaimServerLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) con el campo [PFLobbyClaimServerLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) establecido en un error.   <br /><br /> Esta operación está pensada principalmente para permitir que las entidades game\_server tomen la propiedad de lobbies propiedad de un servidor cuyos propietarios se han desconectado o se desconectarán. Normalmente, esto interesa a las entidades game\_server que desean migrar la propiedad a otra entidad game\_server o a las entidades game\_server que necesitan recuperar la propiedad de sus propios servidores después de algún error grave que les haga perder el acceso al identificador del lobby, como un bloqueo.   <br /><br /> Un servidor de juego no puede reclamar la propiedad de un lobby al que otra entidad game\_server esté conectada actualmente.

## Requisitos

**Encabezado:** PFLobby.h

## Consulte también

[Miembros de PFLobby](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyGetLobbyProperty](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyproperty.md)
- [PFLobbyGetLobbyPropertyKeys](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbypropertykeys.md)
- [PFLobbyGetMembers](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md)
- [PFLobbyGetSearchProperty](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchproperty.md)
- [PFLobbyGetSearchPropertyKeys](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchpropertykeys.md)