跳轉到主要內容

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年10月6日