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

> Referência de PFMultiplayerClaimServerLobby para reivindicar a propriedade de um lobby do PlayFab existente pertencente ao servidor como game_server por meio do SDK C++ do PlayFab Multiplayer.

Reivindica a propriedade de um lobby de servidor preexistente.

## Sintaxe

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

### Parâmetros

**`handle`**   PFMultiplayerHandle

O identificador da instância da API PFMultiplayer.

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

A chave de entidade do PlayFab do servidor de jogo que está reivindicando o lobby. O tipo de entidade dele deve ser "game\_server".

**`lobbyId`**   char\*\
*terminada em nulo*

A ID do lobby a ser reivindicado.

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

Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.

**`lobby`**   PFLobbyHandle\*\
*opcional, saída alocada pela biblioteca*

O objeto de lobby de saída opcional, que pode ser usado para enfileirar operações para execução imediata após a conclusão desta operação.

### Valor retornado

Tipo: HRESULT

`S_OK` se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de [PFMultiplayerGetErrorMessage()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentários

Para usar este recurso, você precisa definir PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS antes de incluir PFLobby.h. \
\
 Esta é uma operação assíncrona. Após a conclusão bem-sucedida, o título receberá uma [PFLobbyClaimServerLobbyCompletedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) com o campo [PFLobbyClaimServerLobbyCompletedStateChange::result](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) definido como `S_OK`. Após uma conclusão com falha, o título receberá uma [PFLobbyClaimServerLobbyCompletedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) com o campo [PFLobbyClaimServerLobbyCompletedStateChange::result](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyclaimserverlobbycompletedstatechange) definido como uma falha.   \
\
 Esta operação destina-se principalmente a permitir que entidades game\_server assumam a propriedade de lobbies pertencentes ao servidor cujos proprietários se desconectaram ou se desconectarão. Normalmente, isso é relevante para entidades game\_server que querem migrar a propriedade para outra entidade game\_server ou para entidades game\_server que precisam recuperar a propriedade dos próprios servidores após alguma falha fatal que as faça perder o acesso ao identificador do lobby, como uma falha do processo.   \
\
 Um servidor de jogo não pode reivindicar a propriedade de um lobby ao qual outra entidade game\_server esteja conectada no momento.

## Requisitos

**Cabeçalho:** PFLobby.h

## Confira também

[Membros do PFLobby](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

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