> ## 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](/zh-TW/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 值，您可以確保只有在群組自您上次載入該版本後未曾更新的情況下，才會執行群組角色更新。如果同一個群組已被更新，則不會進行要求的更新，且傳回的 SetResult 值將為 None。

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

群組的識別碼。

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

（選擇性）要更新的角色識別碼。角色識別碼的長度必須介於 1 到 64 個字元之間。

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

角色的新名稱。

## 需求

**標頭：** PFGroupsTypes.h

## 另請參閱

[PFGroupsTypes 成員](/zh-TW/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

- [PFGroupsUpdateRoleAsync](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)
- [服務 C API 概觀 - PFGroupsTypes.h](/zh-TW/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsUpdateGroupRequest](/zh-TW/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprequest.md)
- [PFGroupsUpdateGroupRoleResponse](/zh-TW/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouproleresponse.md)
- [PFGroupsCreateGroupRoleRequest](/zh-TW/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md)