> ## 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/ja-jp/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/ja-jp/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*

グループの識別子。

**`members`**   [PFEntityKey](https://docs.xbox.com/ja-jp/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/ja-jp/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)


## Related topics

- [PFGroupsChangeMemberRoleAsync](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [Services C API overview - PFGroupsTypes.h](https://docs.xbox.com/ja-jp/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)