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

# PFGroupsUpdateGroupRoleRequest

> PFGroupsUpdateGroupRoleRequest 데이터 모델입니다. 역할 이름을 업데이트합니다. 업데이트 성공 여부에 대한 정보를 반환합니다.

PFGroupsUpdateGroupRoleRequest 데이터 모델입니다. 역할 이름을 업데이트합니다. 업데이트 성공 여부에 대한 정보를 반환합니다.

## 구문

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

### 멤버

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

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

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

**`expectedProfileVersion`**   int32\_t const\*<br />*may be nullptr*

(선택 사항) 동시성 제어에 사용되는 선택적 필드입니다. GetGroup API에서 이전에 반환된 ProfileVersion 값을 지정하면, 마지막으로 로드한 버전 이후 다른 클라이언트가 그룹을 업데이트하지 않은 경우에만 그룹 데이터 업데이트가 수행되도록 할 수 있습니다.

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

그룹의 식별자입니다.

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

(선택 사항) 업데이트할 역할의 ID입니다. 역할 ID는 길이가 1\~64자여야 합니다.

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

역할의 새 이름입니다.

## 요구 사항

**헤더:** PFGroupsTypes.h

## 참고 항목

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


## Related topics

- [PFGroupsUpdateRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)
- [Services C API overview - PFGroupsTypes.h](/ko/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsUpdateGroupRequest](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprequest.md)
- [PFGroupsUpdateGroupRoleResponse](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouproleresponse.md)
- [PFGroupsCreateGroupRoleRequest](/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md)