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

# PFGroupsChangeMemberRoleAsync

> エンティティのリストのロール メンバーシップを、あるロールから別のロールに変更します。

エンティティのリストのロール メンバーシップを、あるロールから別のロールに変更します。

## 構文

```cpp theme={null}
HRESULT PFGroupsChangeMemberRoleAsync(  
    PFEntityHandle entityHandle,  
    const PFGroupsChangeMemberRoleRequest* request,  
    XAsyncBlock* async  
)  
```

### パラメーター

**`entityHandle`**   PFEntityHandle

認証に使用する PFEntityHandle。

**`request`**   [PFGroupsChangeMemberRoleRequest\*](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupschangememberrolerequest.md)

値が設定されたリクエスト オブジェクト。

**`async`**   XAsyncBlock\*\
*Inout*

非同期操作用の XAsyncBlock。

### 戻り値

型: HRESULT

この API 操作の結果コード。

## 解説

この API はすべてのプラットフォームで利用できます。単一の操作で、エンティティのリストのロール メンバーシップをあるロールから別のロールへ変更します。移動先のロールは既に存在している必要があります。これは、エンティティを移動先ロールに追加し、移動元ロールから削除することと等価です。成功時には何も返されません。GroupAddMembersAsync、GroupCreateRoleAsync、GroupRemoveMembersAsync も参照してください。操作の状態を取得するには XAsyncGetStatus を呼び出します。サービス呼び出しが失敗した場合、非同期処理の結果は E\_PF\_ROLE\_DOES\_NOT\_EXIST またはグローバル PlayFab サービス エラーのいずれかになります。エラー処理の詳細については、ドキュメント ページ「Handling PlayFab Errors」を参照してください。

## 要件

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

## 関連項目

[PFGroups のメンバー](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/pfgroups_members.md)


## Related topics

- [Services C API overview - PFGroups.h](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsChangeMemberRoleRequest](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupschangememberrolerequest.md)
- [Change Member Role](https://docs.xbox.com/api-reference/groups/change-member-role.md)
- [group_role_members_added](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/Groups/group-role-members-added.md)
- [group_role_members_removed](https://docs.xbox.com/ja-jp/services/playfab/api-references/events/Groups/group-role-members-removed.md)