通过

XblMultiplayerSessionGetRoleByName

  • 项目

按角色类型名称和角色名称提取 XblMultiplayerRole 对象。

语法

HRESULT XblMultiplayerSessionGetRoleByName(  
         XblMultiplayerSessionHandle handle,  
         const char* roleTypeName,  
         const char* roleName,  
         const XblMultiplayerRole** role  
)

参数

handle _In_
类型：XblMultiplayerSessionHandle

多人游戏会话的句柄。

roleTypeName _In_z_
类型：char*

该角色所属的角色类型的名称。

roleName _In_z_
类型：char*

角色的名称。

role _Out_
类型：XblMultiplayerRole**

传回指向角色对象以及有关该角色的信息的指针。 指针的内存在 XblMultiplayerSessionHandle 对象的生存期内有效，直到它关闭为止。 如果不存在此类角色，则将传回 nullptr。

返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

备注

请注意，在调用 XblMultiplayerWriteSessionAsync 之前，新创建的会话将不会填充角色信息。

要求

头文件：multiplayer_c.h

图书馆： Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

multiplayer_c