> ## 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.

# XblMultiplayerWriteSessionAsync

> XblMultiplayerWriteSessionAsync

# XblMultiplayerWriteSessionAsync

Grava uma sessão multijogador nova ou atualizada no serviço. A sessão deve ter uma referência de sessão válida. Se ela não tiver sido criada com uma, use XblMultiplayerWriteSessionByHandleAsync.

## Sintaxe

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         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.

*async*   \_Inout\_\
Tipo: XAsyncBlock\*

O AsyncBlock desta operação.

### Valor retornado

Tipo: HRESULT

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

## Comentários

No retorno de chamada assíncrono, chame XblMultiplayerWriteSessionResult() para obter um identificador XblMultiplayerSessionHandle. Use esse identificador para chamar XblMultiplayerSessionWriteStatus() e obter o status de gravação. A chamada para XblMultiplayerWriteSessionAsync() só falhará se os argumentos passados para ela forem inválidos ou, em casos muito raros, se não for possível iniciar a tarefa assíncrona.

## Chamada REST

Chama V105 PUT /serviceconfigs/{serviceConfigurationId}/sessionTemplates/{sessiontemplateName}/sessions/{sessionName}

## Requisitos

**Cabeçalho:** multiplayer\_c.h

**Biblioteca:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 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)
- [XblMultiplayerWriteSessionResult](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerSessionWriteStatus](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)
- [XblMultiplayerWriteSessionByHandleResult](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerSessionCreateHandle](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncreatehandle.md)