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

# PFGroupsChangeMemberRoleAsync

> Changes the role membership of a list of entities from one role to another.

Changes the role membership of a list of entities from one role to another.

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

PFEntityHandle to use for authentication.

**`request`**   [PFGroupsChangeMemberRoleRequest\*](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupschangememberrolerequest)

Populated request object.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock for the async operation.

### Return value

Type: HRESULT

Result code for this API operation.

## Remarks

This API is available on all platforms. Changes the role membership of a list of entities from one role to another in a single operation. The destination role must already exist. This is equivalent to adding the entities to the destination role and removing from the origin role. Returns nothing if successful. See also GroupAddMembersAsync, GroupCreateRoleAsync, GroupRemoveMembersAsync. Call XAsyncGetStatus to get the status of the operation. If the service call is unsuccessful, the async result will be E\_PF\_ROLE\_DOES\_NOT\_EXIST or any of the global PlayFab Service errors. See doc page "Handling PlayFab Errors" for more details on error handling.

## Requirements

**Header:** PFGroups.h

## See also

[PFGroups members](/services/playfab/api-references/c/pfgroups/pfgroups_members)


## Related topics

- [Services C API overview - PFGroups.h](/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsChangeMemberRoleRequest](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupschangememberrolerequest.md)
- [members_role_updated](/services/playfab/api-references/events/Groups/members-role-updated.md)
- [PFGroupsListGroupMembersAsync](/services/playfab/api-references/c/pfgroups/functions/pfgroupslistgroupmembersasync.md)
- [PFGroupsAddMembersAsync](/services/playfab/api-references/c/pfgroups/functions/pfgroupsaddmembersasync.md)