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

# XblMultiplayerManagerJoinGameFromLobby

> XblMultiplayerManagerJoinGameFromLobby

# XblMultiplayerManagerJoinGameFromLobby

Cria uma nova sessão de jogo para a sessão de lobby ou ingressa em uma sessão de jogo existente, se houver uma para a sessão de lobby.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinGameFromLobby(  
         const char* sessionTemplateName  
)  
```

### Parâmetros

*sessionTemplateName*   \_In\_z\_\
Tipo: char\*

O nome do modelo de sessão no qual a sessão de jogo será baseada.

### Valor retornado

Tipo: HRESULT

Código de retorno HRESULT desta operação de API.

## Comentários

Esta função cria uma nova sessão de jogo e adiciona os membros atuais da sessão de lobby à sessão de jogo, se ainda não existir uma sessão de jogo. Se um novo usuário ingressar na sessão de lobby depois que uma sessão de jogo já tiver sido criada, esta função encontrará a sessão de jogo existente no Multiplayer Session Directory (MPSD) usando um identificador de transferência na sessão de lobby e, em seguida, adicionará o novo usuário à sessão de jogo usando esse identificador de transferência. Para obter mais informações, confira [Visão geral dos conceitos de multijogador](/pt-BR/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts). Se não existir uma sessão de lobby, provavelmente porque [XblMultiplayerManagerInitialize](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize) não foi chamada antes de chamar esta função, ocorrerá um erro. Também ocorrerá um erro se o matchmaking estiver em andamento. Esta função não migra as propriedades existentes da sessão de lobby para a sessão de jogo. <br />O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como `XblMultiplayerEventType::JoinGameCompleted`. Você pode chamar [XblMultiplayerManagerDoWork](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) para recuperar eventos multijogador.  <br />Ao tentar ingressar em uma sessão de lobby, o serviço retornará `HTTP_E_STATUS_BAD_REQUEST` se o servidor estiver cheio.  <br />Depois de ingressar, você pode definir as propriedades da sessão de jogo chamando [XblMultiplayerManagerGameSessionSetProperties](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties) ou [XblMultiplayerManagerGameSessionSetSynchronizedProperties](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties), ou pode definir o host da sessão de jogo chamando [XblMultiplayerManagerGameSessionSetSynchronizedHost](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost).

## Requisitos

**Cabeçalho:** multiplayer\_manager\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Confira também

[multiplayer\_manager\_c](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerJoinability](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinability)\
[XblMultiplayerManagerJoinGame](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame)\
[XblMultiplayerManagerJoinLobby](/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby)


## Related topics

- [XblMultiplayerManagerJoinGameFromLobby](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)
- [XblMultiplayerManagerJoinLobby](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)