XblMultiplayerWriteSessionByHandleAsync
使用指定的会话句柄将新的或更新的多人游戏会话写入服务。
语法
HRESULT XblMultiplayerWriteSessionByHandleAsync(
XblContextHandle xblContext,
XblMultiplayerSessionHandle multiplayerSession,
XblMultiplayerSessionWriteMode writeMode,
const char* handleId,
XAsyncBlock* async
)
参数
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 标识符。 调用方通常会从另一个玩家的 XblMultiplayerActivityDetails 通过 XblMultiplayerGetActivitiesForUsersAsync() API 或从一个邀请获取 handleId。 仅当多人游戏会话对象没有有效的 XblMultiplayerSessionReference 时才使用此方法，因为句柄的生命周期可能短于其指向的会话的生命周期。
要求
头文件：multiplayer_c.h
库：Microsoft.Xbox.Services.141.GSDK.C.lib