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

# 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](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(省略可能) リクエストに関連付けられている省略可能なカスタム タグ (ビルド番号、外部トレース識別子など)。

**`customTagsCount`**   uint32\_t

customTags の数

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

(省略可能) エンティティがメンバーになるロールの ID。これは既存のロールである必要があります。ロール ID は 1 ～ 64 文字の長さである必要があります。

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

グループの識別子。

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

グループ内でロール間を移動させるエンティティの一覧。この一覧に含まれるすべてのエンティティは、そのグループと移動元ロールのメンバーである必要があります。

**`membersCount`**   uint32\_t

members の数

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

エンティティが現在メンバーになっているロールの ID。ロール ID は 1 ～ 64 文字の長さである必要があります。

## 要件

**ヘッダー:** PFGroupsTypes.h

## 関連項目

[PFGroupsTypes のメンバー](/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

- [PFGroupsChangeMemberRoleAsync](/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [Services C API overview - PFGroupsTypes.h](/ja-jp/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [group_role_members_added](/ja-jp/services/playfab/api-references/events/Groups/group-role-members-added.md)
- [group_role_members_removed](/ja-jp/services/playfab/api-references/events/Groups/group-role-members-removed.md)
- [PFGroupsEntityMemberRole](/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsentitymemberrole.md)