> ## 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](/zh-CN/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)
- [服务 C API 概览 - PFGroupsTypes.h](/zh-CN/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsUpdateGroupRequest](/zh-CN/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprequest.md)
- [PFGroupsUpdateGroupRoleResponse](/zh-CN/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouproleresponse.md)
- [PFGroupsCreateGroupRoleRequest](/zh-CN/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md)