> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

Contexto do XBOX Live do usuário local.

*multiplayerSession*   \_In\_\
Tipo: [XblMultiplayerSessionHandle](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle.md)

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

*writeMode*   \_In\_\
Tipo: [XblMultiplayerSessionWriteMode](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)

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](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)

## Confira também

[multiplayer\_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members.md)


## Related topics

- [XblMultiplayerSessionWriteMode](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerWriteSessionAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [Navegação de sessões multiplayer](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/concepts/live-session-browse.md)
- [Visão geral do Multiplayer Session Directory](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Recebendo convites](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)