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

# PFGroupsUpdateGroupRequest

> PFGroupsUpdateGroupRequest 資料模型。更新群組的相關資料，例如名稱或預設成員角色。傳回更新是否成功的相關資訊。只有 Title 擁有者可以修改群組的管理角色。

PFGroupsUpdateGroupRequest 資料模型。更新群組的相關資料，例如名稱或預設成員角色。傳回更新是否成功的相關資訊。只有 Title 擁有者可以修改群組的管理角色。

## 語法

```cpp theme={null}
typedef struct PFGroupsUpdateGroupRequest {  
    const char* adminRoleId;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    int32_t const* expectedProfileVersion;  
    PFEntityKey const* group;  
    const char* groupName;  
    const char* memberRoleId;  
} PFGroupsUpdateGroupRequest;  
```

### 成員

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

（選擇性）選擇性：要設定為群組新系統管理員角色的現有角色識別碼。

**`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\*

群組的識別碼。

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

（選擇性）選擇性：群組的新名稱。

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

（選擇性）選擇性：要設定為群組新成員角色的現有角色識別碼。

## 需求

**標頭：** PFGroupsTypes.h

## 另請參閱

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


## Related topics

- [PFGroupsUpdateGroupAsync](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdategroupasync.md)
- [服務 C API 概觀 - PFGroupsTypes.h](/zh-TW/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [Update Group](/api-reference/groups/update-group.md)
- [PFGroupsUpdateGroupRoleRequest](/zh-TW/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprolerequest.md)
- [Update Exclusion Group](/api-reference/experimentation/update-exclusion-group.md)