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

# XblMultiplayerWriteSessionResult

> XblMultiplayerWriteSessionResult

# XblMultiplayerWriteSessionResult

获取 XblMultiplayerWriteSessionAsync 操作的结果。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionResult(  
         XAsyncBlock* async,  
         XblMultiplayerSessionHandle* handle  
)  
```

### 参数

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

此操作的 AsyncBlock。

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

回传本地多人游戏会话对象新实例的句柄。调用方必须通过调用 [XblMultiplayerSessionCloseHandle](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionclosehandle) 释放 XblMultiplayerSessionHandle。使用 XblMultiplayerSession\* API 从该句柄中获取会话数据。如果不需要更新后的会话对象，传递 nullptr 将导致立即清理新的多人游戏会话对象。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。如果出现网络错误或失败的 HTTP 状态代码（除非是 412（前置条件失败）），它将是一个失败的 HRESULT。412 会返回成功，因为服务同时返回最新会话状态，因此你必须调用 XblMultiplayerSessionWriteStatus() 获取写入状态，并调用 XblMultiplayerSession\* API 从该句柄获取会话数据。

## 备注

请注意，如果你离开一个自己是最后一名成员的会话，且 sessionEmptyTimeout 等于 0，则该会话将被立即删除。调用 XblMultiplayerSessionWriteStatus() 获取写入状态。

## 要求

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

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

## 另请参阅

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


## Related topics

- [XblMultiplayerWriteSessionAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [多人游戏任务](/zh-CN/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [XblMultiplayerWriteSessionByHandleResult](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerQuerySessionsResult](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerquerysessionsresult.md)
- [XblMultiplayerSessionWriteMode](/zh-CN/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)