Skip to main content

XblMultiplayerSessionGetRoleByName

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

语法

参数

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
最后修改于 2026年8月13日