Skip to main content

XblMultiplayerManagerJoinLobby

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

Sintaxe

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 de outro usuário, chamando XblMultiplayerGetActivitiesForUsersAsync. Para obter mais informações sobre atividades multijogador, confira Atividades.
O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como XblMultiplayerEventType::JoinLobbyCompleted. Você pode chamar XblMultiplayerManagerDoWork 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 ou pode definir o host da sessão de lobby chamando XblMultiplayerManagerLobbySessionSetSynchronizedHost, 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 ou XblMultiplayerManagerLobbySessionInviteFriends. Se você não precisar de uma sessão de lobby e não tiver adicionado usuários locais chamando XblMultiplayerManagerLobbySessionAddLocalUser, poderá chamar XblMultiplayerManagerJoinGame 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

Confira também

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby
Last modified on October 6, 2026