Skip to main content

​
XblMultiplayerWriteSessionByHandleAsync

Grava uma sessão multijogador nova ou atualizada no serviço, usando o identificador especificado para a sessão.

​
Sintaxe

​
Parâmetros

xblContext   _In_
Tipo: XblContextHandle Contexto do XBOX Live do usuário local. multiplayerSession   _In_
Tipo: XblMultiplayerSessionHandle Um objeto MultiplayerSession que foi modificado com as alterações a serem gravadas. writeMode   _In_
Tipo: XblMultiplayerSessionWriteMode O tipo de operação de gravação. handleId   _In_
Tipo: char* A ID do identificador que deve ser usado ao gravar a sessão. async   _In_
Tipo: XAsyncBlock* O AsyncBlock desta operação.

​
Valor retornado

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

​
Comentários

Um identificador é um ponteiro do lado do serviço para uma sessão. A ID do identificador é um GUID do identificador. Normalmente, os chamadores obtêm o handleId do XblMultiplayerActivityDetails de outro jogador por meio da API XblMultiplayerGetActivitiesForUsersAsync() ou de um convite. Use este método somente se o objeto de sessão multijogador não tiver um XblMultiplayerSessionReference válido, pois o tempo de vida de um identificador pode ser menor que o da sessão para a qual ele aponta.

​
Requisitos

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

​
Documentação conceitual

​
Confira também

multiplayer_c
Last modified on October 6, 2026