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

# XblMultiplayerWriteSessionByHandleAsync

> XblMultiplayerWriteSessionByHandleAsync

# XblMultiplayerWriteSessionByHandleAsync

使用指定的会话句柄，将新的或已更新的多人游戏会话写入服务。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerWriteSessionByHandleAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         const char* handleId,  
         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)

写入操作的类型。

*handleId*   \_In\_\
类型：char\*

写入会话时应使用的句柄的 ID。

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

此操作的 AsyncBlock。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

句柄是指向会话的服务端指针。句柄 ID 是句柄的 GUID 标识符。调用方通常通过 XblMultiplayerGetActivitiesForUsersAsync() API 从其他玩家的 XblMultiplayerActivityDetails 中获取 handleId，或从邀请中获取。仅当你的多人游戏会话对象没有有效的 XblMultiplayerSessionReference 时才使用此方法，因为句柄的生存期可能比其指向的会话的生存期短。

## 要求

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

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

## 概念文档

* [接收邀请](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)

## 另请参阅

[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)
- [XblMultiplayerWriteSessionAsync](/zh-CN/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [接收邀请](/zh-CN/services/xbox-services/multiplayer/invites/how-to/live-invites-receive.md)
- [从 MPSD 迁移到 PlayFab Multiplayer 和 MPA](/zh-CN/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [多人游戏会话目录概述](/zh-CN/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)