XblMultiplayerGetSessionByHandleAsync

从服务器获取会话对象及其所有属性,给定了会话句柄 ID。

语法

HRESULT XblMultiplayerGetSessionByHandleAsync(  
         XblContextHandle xblContext,  
         const char* handleId,  
         XAsyncBlock* async  
)  

参数

xblContext _In_
类型:XblContextHandle

本地用户的 Xbox Live 上下文。

handleId _In_
类型:char*

多人游戏句柄 ID,用于唯一标识会话。

async _In_
类型:XAsyncBlock*

此操作的 AsyncBlock。

返回值

类型:HRESULT

此 API 操作的 HRESULT 返回代码。

备注

句柄是指向会话的服务端指针。 handleId 是句柄的 GUID 标识符。 调用方通常会从另一个玩家的 XblMultiplayerActivityDetails 或从一个邀请获取 handleId。

REST 调用

调用 GET /handles/{handleId}/session

要求

头文件:multiplayer_c.h

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

另请参阅

multiplayer_c