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

# PFMultiplayerJoinArrangedLobby

> Ingresse em um lobby do PlayFab usando uma cadeia de caracteres de combinação do matchmaking ou de outro serviço; o lobby é inicializado a partir da configuração se ninguém tiver ingressado.

Ingressa em um lobby usando uma cadeia de caracteres de combinação fornecida por outro serviço, como o matchmaking. Se ninguém tiver ingressado no lobby ainda, o lobby será inicializado usando os parâmetros de configuração.

## Sintaxe

```cpp theme={null}
HRESULT PFMultiplayerJoinArrangedLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* newMember,  
    const char* arrangementString,  
    const PFLobbyArrangedJoinConfiguration* configuration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### Parâmetros

**`handle`**   PFMultiplayerHandle

O identificador da instância da API PFMultiplayer.

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

A entidade local do PlayFab que está ingressando no lobby.

**`arrangementString`**   char\*\
*terminada em nulo*

A cadeia de caracteres de combinação usada pela entidade para ingressar no lobby.

**`configuration`**   [PFLobbyArrangedJoinConfiguration\*](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyarrangedjoinconfiguration)

Os dados de configuração iniciais usados para inicializar o lobby, se ninguém tiver ingressado no lobby ainda.

**`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

Esta é uma operação assíncrona. Após a conclusão bem-sucedida, o título receberá uma [PFLobbyMemberAddedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange) seguida de uma [PFLobbyJoinArrangedLobbyCompletedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) com o campo [PFLobbyJoinArrangedLobbyCompletedStateChange::result](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) definido como `S_OK`. Após uma conclusão com falha, o título receberá uma [PFLobbyJoinArrangedLobbyCompletedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) com o campo [PFLobbyJoinArrangedLobbyCompletedStateChange::result](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) definido como uma falha. <br /><br /> Ao usar o matchmaking por meio desta biblioteca, [PFMatchmakingMatchDetails::lobbyArrangementString](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails) pode ser usado com este método para ingressar em um lobby com todos os usuários que foram combinados.

## Requisitos

**Cabeçalho:** PFLobby.h

## Confira também

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


## Related topics

- [Usar o lobby e o matchmaking juntos](/pt-BR/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
- [Migrando do MPSD para o PlayFab Multiplayer e o MPA](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [PFMatchmakingMatchDetails](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails.md)
- [PFLobbyStateChangeType](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbystatechangetype.md)
- [Join Arranged Lobby](/api-reference/lobby/join-arranged-lobby.md)