> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFGroupsChangeMemberRoleRequest

> PFGroupsChangeMemberRoleRequest 数据模型。在单个操作中将一组实体的角色成员关系从一个角色更改为另一个角色。

PFGroupsChangeMemberRoleRequest 数据模型。在单个操作中将一组实体的角色成员关系从一个角色更改为另一个角色。目标角色必须已存在。这相当于将实体添加到目标角色并从原角色中移除。成功时不返回任何内容。

## 语法

```cpp theme={null}
typedef struct PFGroupsChangeMemberRoleRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    const char* destinationRoleId;  
    PFEntityKey const* group;  
    PFEntityKey const* members;  
    uint32_t membersCount;  
    const char* originRoleId;  
} PFGroupsChangeMemberRoleRequest;  
```

### 成员

**`customTags`**   [PFStringDictionaryEntry](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*may be nullptr*

（可选）与请求关联的可选自定义标记（例如生成号、外部跟踪标识符等）。

**`customTagsCount`**   uint32\_t

customTags 的数量

**`destinationRoleId`**   const char\*\
*is null-terminated*

（可选）实体将成为其成员的角色的 ID。此角色必须已存在。角色 ID 长度必须介于 1 到 64 个字符之间。

**`group`**   [PFEntityKey](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*

组的标识符。

**`members`**   [PFEntityKey](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*

要在组中角色之间移动的实体列表。此列表中的所有实体必须是该组和原角色的成员。

**`membersCount`**   uint32\_t

members 的数量

**`originRoleId`**   const char\*\
*is null-terminated*

实体当前所属角色的 ID。角色 ID 长度必须介于 1 到 64 个字符之间。

## 要求

**头文件：** PFGroupsTypes.h

## 另请参阅

[PFGroupsTypes 成员](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)


## Related topics

- [PFGroupsChangeMemberRoleAsync](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [服务 C API 概览 - PFGroupsTypes.h](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [Change Member Role](https://docs.xbox.com/api-reference/groups/change-member-role.md)
- [Is Member](https://docs.xbox.com/api-reference/groups/is-member.md)
- [List Group Members](https://docs.xbox.com/api-reference/groups/list-group-members.md)