Skip to main content

XblMultiplayerManagerLobbySessionSetSynchronizedHost

Define o host da sessão de lobby, usando XblMultiplayerSessionWriteMode::SynchronizedUpdate.

Sintaxe

Parâmetros

deviceToken   _In_
Tipo: char*
O token de dispositivo do host. context   _In_opt_
Tipo: void*
Opcional. Os dados definidos pelo aplicativo para correlacionar o XblMultiplayerEvent à chamada inicial.

Valor retornado

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

Comentários

Esta função define o host da sessão de lobby. Use esta função para garantir a atomicidade e resolver conflitos entre dispositivos que tentam definir o host ao mesmo tempo.
O serviço poderá rejeitar a solicitação de definição do host se ocorrer uma condição de corrida devido a um conflito. Se a solicitação for rejeitada, o serviço retornará HTTP_E_STATUS_PRECOND_FAILED. Se ocorrer um conflito, reavalie a necessidade de alterar o host e, se necessário, chame esta função novamente para reenviar a solicitação.
O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como XblMultiplayerEventType::SynchronizedHostWriteCompleted. Você pode chamar XblMultiplayerManagerDoWork para recuperar eventos multijogador. Observe que os tokens de dispositivo do host são gerados a partir do endereço de dispositivo seguro de um membro da sessão; portanto, verifique se o endereço de dispositivo seguro está definido para o host desejado antes de chamar este método.

Requisitos

Cabeçalho: multiplayer_manager_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Confira também

multiplayer_manager_c
XblMultiplayerManagerLobbySessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress
Last modified on October 6, 2026