> ## 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](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessioncurrentusersetroles.md)
- [XblMutableRoleSettings](/ko/reference/live/xsapi-c/multiplayer_c/enums/xblmutablerolesettings.md)
- [XblMultiplayerRoleType](/ko/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayerroletype.md)
- [XblMultiplayerSessionRoleTypes](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionroletypes.md)
- [XblMultiplayerSessionMemberRole](/ko/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole.md)
