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

# 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](/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.

*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](/pt-BR/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionWriteMode](/pt-BR/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerWriteSessionResult](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerSessionWriteStatus](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)
- [XblMultiplayerWriteSessionByHandleResult](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerSessionCreateHandle](/pt-BR/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncreatehandle.md)