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

# XblMultiplayerManagerJoinGame

> XblMultiplayerManagerJoinGame

# XblMultiplayerManagerJoinGame

Ingressa em uma sessão de jogo usando o nome de sessão globalmente exclusivo.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinGame(  
         const char* sessionName,  
         const char* sessionTemplateName,  
         const uint64_t* xuids,  
         size_t xuidsCount  
)  
```

### Parâmetros

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

O nome de sessão globalmente exclusivo da sessão de jogo.

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

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

*xuids*   \_In\_opt\_\
Tipo: uint64\_t\*

Uma matriz de IDs de usuário do XBOX (XUIDs) que representa os usuários que você deseja que façam parte do jogo.

*xuidsCount*   \_In\_\
Tipo: size\_t

O número de elementos na matriz especificada para `xuids`.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Esta função faz uma lista de usuários do XBOX, especificada em `xuids`, ingressar na sessão de jogo identificada pelo nome de sessão globalmente exclusivo especificado em `sessionName.` Você pode obter o nome de sessão globalmente exclusivo nos resultados do matchmaking de terceiros do título e deve chamar esta função para todos os clientes que precisam ingressar no jogo. \
O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como `XblMultiplayerEventType::JoinGameCompleted`. Você pode chamar [XblMultiplayerManagerDoWork](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) para recuperar eventos multijogador.  \
Ao tentar ingressar em uma sessão de jogo, o serviço retornará `HTTP_E_STATUS_BAD_REQUEST` se o servidor estiver cheio.  \
Depois de ingressar, você pode definir as propriedades da sessão de jogo chamando [XblMultiplayerManagerGameSessionSetProperties](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetproperties.md) ou [XblMultiplayerManagerGameSessionSetSynchronizedProperties](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedproperties.md), ou pode definir o host da sessão de jogo chamando [XblMultiplayerManagerGameSessionSetSynchronizedHost](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessionsetsynchronizedhost.md).

## Requisitos

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

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

## Confira também

[multiplayer\_manager\_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)


## Related topics

- [XblMultiplayerManagerJoinGameFromLobby](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.md)
- [XblMultiplayerManagerLeaveGame](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerleavegame.md)
- [XblMultiplayerManagerJoinLobby](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)