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

# PFGroupsCreateGroupRoleRequest

> PFGroupsCreateGroupRoleRequest 데이터 모델입니다. 기존 그룹 내에서 멤버가 없는 새 역할을 만듭니다. 역할 ID와 역할 이름은 모두 그룹 내에서 고유해야 합니다.

PFGroupsCreateGroupRoleRequest 데이터 모델입니다. 기존 그룹 내에서 멤버가 없는 새 역할을 만듭니다. 역할 ID와 역할 이름은 모두 그룹 내에서 고유해야 하지만, 이름은 ID와 동일할 수 있습니다. 역할 ID는 생성 시 설정되며 변경할 수 없습니다. 만들어진 역할에 대한 정보를 반환합니다.

## 구문

```cpp theme={null}
typedef struct PFGroupsCreateGroupRoleRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* group;  
    const char* roleId;  
    const char* roleName;  
} PFGroupsCreateGroupRoleRequest;  
```

### 멤버

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

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

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

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

그룹의 식별자입니다.

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

역할의 ID입니다. 그룹 내에서 고유해야 하며 변경할 수 없습니다. 역할 ID는 길이가 1\~64자여야 하며, a-Z, A-Z, 0-9, '(', ')', '\_', '-' 및 '.'로 제한됩니다.

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

역할의 이름입니다. 그룹 내에서 고유해야 하며 나중에 변경할 수 있습니다. 역할 이름은 길이가 1\~100자여야 합니다.

## 요구 사항

**헤더:** PFGroupsTypes.h

## 참고 항목

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


## Related topics

- [PFGroupsCreateRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupscreateroleasync.md)
- [Services C API overview - PFGroupsTypes.h](/ko/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsCreateGroupRoleResponse](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouproleresponse.md)
- [PFGroupsUpdateGroupRoleRequest](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprolerequest.md)
- [PFGroupsDeleteRoleRequest](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsdeleterolerequest.md)