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

将新的或已更新的多人游戏会话写入服务。此会话必须具有有效的会话引用。如果创建时没有会话引用，请改用 XblMultiplayerWriteSessionByHandleAsync。

## 语法

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

### 参数

*xblContext*   \_In\_\
类型：[XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

本地用户的 XBOX Live 上下文。

*multiplayerSession*   \_In\_\
类型：[XblMultiplayerSessionHandle](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

已根据要写入的更改进行修改的 MultiplayerSession 对象。

*writeMode*   \_In\_\
类型：[XblMultiplayerSessionWriteMode](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode)

写入操作的类型。

*async*   \_Inout\_\
类型：XAsyncBlock\*

此操作的 AsyncBlock。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

在异步回调中，调用 XblMultiplayerWriteSessionResult() 获取 XblMultiplayerSessionHandle 句柄。使用该句柄调用 XblMultiplayerSessionWriteStatus() 获取写入状态。仅当传递给 XblMultiplayerWriteSessionAsync() 的参数无效，或在极少数无法启动异步任务的情况下，该调用才会失败。

## REST 调用

调用 V105 PUT /serviceconfigs/{serviceConfigurationId}/sessionTemplates/{sessiontemplateName}/sessions/{sessionName}

## 要求

**头文件：** multiplayer\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

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


## Related topics

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