Skip to main content

XblMultiplayerWriteSessionByHandleAsync

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

语法

参数

xblContext   _In_
类型:XblContextHandle
本地用户的 XBOX Live 上下文。 multiplayerSession   _In_
类型:XblMultiplayerSessionHandle
已根据要写入的更改进行修改的 MultiplayerSession 对象。 writeMode   _In_
类型: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

概念文档

另请参阅

multiplayer_c
最后修改于 2026年8月24日