通过

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.14x.GDK.C.lib

另请参阅

multiplayer_c