> ## 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](/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](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

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