Skip to main content

XblMultiplayerWriteSessionAsync

将新的或已更新的多人游戏会话写入服务。此会话必须具有有效的会话引用。如果创建时没有会话引用,请改用 XblMultiplayerWriteSessionByHandleAsync。

语法

参数

xblContext   _In_
类型:XblContextHandle
本地用户的 XBOX Live 上下文。 multiplayerSession   _In_
类型:XblMultiplayerSessionHandle
已根据要写入的更改进行修改的 MultiplayerSession 对象。 writeMode   _In_
类型:XblMultiplayerSessionWriteMode
写入操作的类型。 async   _Inout_
类型:XAsyncBlock*
此操作的 AsyncBlock。

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。

备注

在异步回调中,调用 XblMultiplayerWriteSessionResult() 获取 XblMultiplayerSessionHandle 句柄。使用该句柄调用 XblMultiplayerSessionWriteStatus() 获取写入状态。仅当传递给 XblMultiplayerWriteSessionAsync() 的参数无效,或在极少数无法启动异步任务的情况下,该调用才会失败。

REST 调用

调用 V105 PUT /serviceconfigs//sessionTemplates//sessions/

要求

头文件: multiplayer_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

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