XblMultiplayerWriteSessionAsync

将新的或更新的多人游戏会话写入服务。 该会话必须具有有效的会话引用。 如果不是用一个创建的,请改用 XblMultiplayerWriteSessionByHandleAsync。

语法

HRESULT XblMultiplayerWriteSessionAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         XAsyncBlock* async  
)  

参数

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/{serviceConfigurationId}/sessionTemplates/{sessiontemplateName}/sessions/{sessionName}

要求

头文件:multiplayer_c.h

库:Microsoft.Xbox.Services.141.GSDK.C.lib

另请参阅

multiplayer_c