XblMultiplayerManagerJoinGame
Ingressa em uma sessão de jogo usando o nome de sessão globalmente exclusivo.Sintaxe
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 emxuids, 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 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 ou XblMultiplayerManagerGameSessionSetSynchronizedProperties, ou pode definir o host da sessão de jogo chamando XblMultiplayerManagerGameSessionSetSynchronizedHost.