> ## 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.

# PFGroupsChangeMemberRoleRequest

> PFGroupsChangeMemberRoleRequest 데이터 모델입니다. 단일 작업으로 엔터티 목록의 역할 멤버십을 하나의 역할에서 다른 역할로 변경합니다.

PFGroupsChangeMemberRoleRequest 데이터 모델입니다. 단일 작업으로 엔터티 목록의 역할 멤버십을 하나의 역할에서 다른 역할로 변경합니다. 대상 역할은 이미 존재해야 합니다. 이는 엔터티를 대상 역할에 추가하고 원본 역할에서 제거하는 것과 동일합니다. 성공한 경우 아무 것도 반환하지 않습니다.

## 구문

```cpp theme={null}
typedef struct PFGroupsChangeMemberRoleRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    const char* destinationRoleId;  
    PFEntityKey const* group;  
    PFEntityKey const* members;  
    uint32_t membersCount;  
    const char* originRoleId;  
} PFGroupsChangeMemberRoleRequest;  
```

### 멤버

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등).

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

**`destinationRoleId`**   const char\*<br />*is null-terminated*

(선택 사항) 엔터티가 멤버가 될 역할의 ID입니다. 기존 역할이어야 합니다. 역할 ID는 길이가 1\~64자여야 합니다.

**`group`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

그룹의 식별자입니다.

**`members`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

그룹 내 역할 간에 이동할 엔터티 목록입니다. 이 목록의 모든 엔터티는 그룹의 멤버이자 원본 역할의 멤버여야 합니다.

**`membersCount`**   uint32\_t

members의 개수입니다.

**`originRoleId`**   const char\*<br />*is null-terminated*

엔터티가 현재 멤버로 있는 역할의 ID입니다. 역할 ID는 길이가 1\~64자여야 합니다.

## 요구 사항

**헤더:** PFGroupsTypes.h

## 참고 항목

[PFGroupsTypes 멤버](/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

- [PFGroupsChangeMemberRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [Services C API overview - PFGroupsTypes.h](/ko/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [group_role_members_added](/ko/services/playfab/api-references/events/Groups/group-role-members-added.md)
- [group_role_members_removed](/ko/services/playfab/api-references/events/Groups/group-role-members-removed.md)
- [PFGroupsIsMemberRequest](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsismemberrequest.md)