> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerSessionSetMutableRoleSettings

> XblMultiplayerSessionSetMutableRoleSettings

# XblMultiplayerSessionSetMutableRoleSettings

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

## 語法

```cpp theme={null}
HRESULT XblMultiplayerSessionSetMutableRoleSettings(  
         XblMultiplayerSessionHandle handle,  
         const char* roleTypeName,  
         const char* roleName,  
         uint32_t* maxMemberCount,  
         uint32_t* targetMemberCount  
)  
```

### 參數

*handle*   \_In\_\
類型：[XblMultiplayerSessionHandle](/zh-TW/reference/live/xsapi-c/multiplayer_c/handles/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](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionCurrentUserSetRoles](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncurrentusersetroles.md)
- [XblMutableRoleSettings](/zh-TW/reference/live/xsapi-c/multiplayer_c/enums/xblmutablerolesettings.md)
- [XblMultiplayerRoleType](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayerroletype.md)
- [XblMultiplayerSessionMemberRole](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole.md)
- [XblMultiplayerSessionRoleTypes](/zh-TW/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionroletypes.md)