Pular para o conteúdo principal

XblMultiplayerWriteSessionResult

Obtém o resultado de uma operação de XblMultiplayerWriteSessionAsync.

Sintaxe

Parâmetros

async   _Inout_
Tipo: XAsyncBlock*
O AsyncBlock desta operação. handle   _Out_
Tipo: XblMultiplayerSessionHandle*
Retorna um identificador para uma nova instância de um objeto de sessão multijogador local. O XblMultiplayerSessionHandle deve ser liberado pelo chamador chamando XblMultiplayerSessionCloseHandle. Use as APIs XblMultiplayerSession* para obter dados da sessão do identificador. Se o objeto de sessão atualizado não for necessário, passar nullptr fará com que o novo objeto de sessão multijogador seja limpo imediatamente.

Valor retornado

Tipo: HRESULT Código de retorno HRESULT desta operação de API. Será um HRESULT de falha se houver um erro de rede ou um código de status HTTP de falha, a menos que seja 412 (Falha na pré-condição). Um 412 retorna sucesso, pois o serviço também retorna o estado mais recente da sessão; portanto, você deve chamar XblMultiplayerSessionWriteStatus() para obter o status de gravação e chamar as APIs XblMultiplayerSession* para obter os dados da sessão do identificador.

Comentários

Observe que, se você sair de uma sessão da qual é o último membro e sessionEmptyTimeout for igual a 0, a sessão será excluída imediatamente. Chame XblMultiplayerSessionWriteStatus() para obter o status de gravação.

Requisitos

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

Confira também

multiplayer_c
Última modificação em 6 de outubro de 2026