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

# XblMultiplayerManagerJoinLobby

> XblMultiplayerManagerJoinLobby

# XblMultiplayerManagerJoinLobby

Faz um usuário do XBOX ingressar em uma sessão de lobby.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerManagerJoinLobby(  
         const char* handleId,  
         XblUserHandle user  
)  
```

### Parâmetros

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

O identificador de atividade da sessão de lobby.

*user*   \_In\_\
Tipo: XblUserHandle

O identificador do usuário que está ingressando na sessão de lobby.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Esta função faz o usuário do XBOX especificado em *user* ingressar na sessão de lobby especificada em *handleId*. O identificador de atividade da sessão de lobby normalmente é recuperado de um convite de jogo ou do valor `HandleId` do [XblMultiplayerActivityDetails](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayeractivitydetails.md) de outro usuário, chamando [XblMultiplayerGetActivitiesForUsersAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforusersasync.md). Para obter mais informações sobre atividades multijogador, confira [Atividades](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities.md). \
O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como `XblMultiplayerEventType::JoinLobbyCompleted`. 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 lobby, 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 lobby chamando [XblMultiplayerManagerLobbySessionSetSynchronizedProperties](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedproperties.md) ou pode definir o host da sessão de lobby chamando [XblMultiplayerManagerLobbySessionSetSynchronizedHost](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsetsynchronizedhost.md), se a sessão de lobby ainda não tiver um host.  \
Você também pode enviar um convite para outro usuário chamando [XblMultiplayerManagerLobbySessionInviteUsers](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md) ou [XblMultiplayerManagerLobbySessionInviteFriends](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md). Se você não precisar de uma sessão de lobby e não tiver adicionado usuários locais chamando [XblMultiplayerManagerLobbySessionAddLocalUser](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md), poderá chamar [XblMultiplayerManagerJoinGame](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingame.md) e especificar a lista de usuários que ingressarão no jogo.

## Requisitos

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

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

## Documentação conceitual

* [Recebendo convites](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)

## Confira também

[multiplayer\_manager\_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerJoinability](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinability.md)\
[XblMultiplayerManagerJoinGameFromLobby](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoingamefromlobby.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)
- [XblMultiplayerManagerLobbySessionInviteFriends](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md)
- [XblMultiplayerManagerLobbySessionInviteUsers](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
