> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerWriteSessionByHandleAsync

> XblMultiplayerWriteSessionByHandleAsync

# XblMultiplayerWriteSessionByHandleAsync

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

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionByHandleAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         const char* handleId,  
         XAsyncBlock* async  
)  
```

### Parâmetros

*xblContext*   \_In\_\
Tipo: [XblContextHandle](/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

Contexto do XBOX Live do usuário local.

*multiplayerSession*   \_In\_\
Tipo: [XblMultiplayerSessionHandle](/pt-BR/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

Um objeto MultiplayerSession que foi modificado com as alterações a serem gravadas.

*writeMode*   \_In\_\
Tipo: [XblMultiplayerSessionWriteMode](/pt-BR/reference/live/xsapi-c/multiplayer_c/enums/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

* [Recebendo convites](/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## Confira também

[multiplayer\_c](/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerWriteSessionByHandleAsync](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)
- [XblMultiplayerWriteSessionAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [XblMultiplayerSessionWriteMode](/es/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)