跳轉到主要內容

XblMultiplayerSessionSetMutableRoleSettings

設定角色的成員數目上限和/或目標成員數目。

語法

參數

handle   _In_
類型:XblMultiplayerSessionHandle
多人遊戲工作階段的控制代碼。 roleTypeName   _In_z_
類型:char*
要修改之角色的角色類型名稱。 roleName   _In_z_
類型:char*
要修改的角色名稱。 maxMemberCount   _In_opt_
類型:uint32_t*
可擁有此角色的成員數目上限。 targetMemberCount   _In_opt_
類型:uint32_t*
此角色的目標成員數目。

傳回值

類型:HRESULT 此 API 作業的 HRESULT 傳回碼。

備註

只有工作階段擁有者可以修改角色設定,且只能修改可變動的設定 (請參閱 XblMultiplayerRoleType.MutableRoleSettings)。在您的工作階段範本中,也需要針對要修改的特定角色類型,將 ‘hasOwners’ 功能和 ‘ownerManaged’ 設定為 true。

需求

標頭: multiplayer_c.h 程式庫: Microsoft.Xbox.Services.14x.GDK.C.lib

另請參閱

multiplayer_c
最後修改於 2026年10月6日