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

# PFMultiplayerJoinLobbyAsServer

> Referência de PFMultiplayerJoinLobbyAsServer para ingressar em um lobby do PlayFab pertencente ao cliente como entidade game_server por meio das APIs de lobby do SDK C++ do PlayFab Multiplayer.

Ingressa em um lobby pertencente ao cliente como servidor.

## Sintaxe

```cpp theme={null}
HRESULT PFMultiplayerJoinLobbyAsServer(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* server,  
    const char* connectionString,  
    const PFLobbyServerJoinConfiguration* configuration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### Parâmetros

**`handle`**   PFMultiplayerHandle

O identificador da instância da API PFMultiplayer.

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

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

**`connectionString`**   char\*\
*terminada em nulo*

A cadeia de conexão usada pelo servidor para ingressar no lobby.

**`configuration`**   [PFLobbyServerJoinConfiguration\*](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyserverjoinconfiguration.md)

Os dados iniciais pertencentes ao servidor a serem armazenados ao ingressar no lobby.

**`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()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md).

## Comentários

Para usar este recurso, você precisa definir PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS antes de incluir PFLobby.h. \
\
 Esta é uma operação assíncrona. A conclusão da execução deste método não significa necessariamente a conclusão da operação.   \
\
 Após a conclusão bem-sucedida, o título recebe uma [PFLobbyUpdatedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md) com o membro [PFLobbyUpdatedStateChange::serverUpdate](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md) preenchido adequadamente e uma [PFLobbyJoinLobbyAsServerCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md) com o campo [PFLobbyJoinLobbyAsServerCompletedStateChange::result](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md) definido como `S_OK`.   \
\
 Após uma conclusão com falha, o título recebe uma [PFLobbyJoinLobbyAsServerCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md) com o campo [PFLobbyJoinLobbyAsServerCompletedStateChange::result](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md) definido como uma falha.   \
\
 Esta operação é restrita a lobbies pertencentes ao cliente que estão usando conexões.

## Requisitos

**Cabeçalho:** PFLobby.h

## Confira também

[Membros do PFLobby](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [PFLobbyJoinLobbyAsServerCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md)
- [PFLobbyGetLobbyId](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyid.md)
- [Notas de versão do SDK C++ do PlayFab Multiplayer](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Propriedade do lobby](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/owner-requirements-and-privileges.md)
- [PFLobbyGetServerConnectionStatus](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetserverconnectionstatus.md)