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

# XblMultiplayerWriteSessionByHandleResult

> XblMultiplayerWriteSessionByHandleResult

# XblMultiplayerWriteSessionByHandleResult

获取 XblMultiplayerWriteSessionAsync 操作的结果。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionByHandleResult(  
         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) 释放该句柄。如果不需要更新后的会话对象，传递 nullptr 将导致立即清理新的多人游戏会话对象。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

请注意，如果你离开一个自己是最后一名成员的会话，且 sessionEmptyTimeout 等于 0，则该会话将被立即删除，并会返回 nullptr。

## 要求

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

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

## 另请参阅

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


## Related topics

- [XblMultiplayerWriteSessionResult](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerWriteSessionAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)
- [XblMultiplayerSessionWriteMode](/zh-CN/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionwritemode.md)
- [XblMultiplayerSessionWriteStatus](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)