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

# PFGroupsUpdateRoleAsync

> Updates metadata about a role.

Updates metadata about a role.

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

PFEntityHandle to use for authentication.

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

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. Updates the role name. Returns information about whether the update was successful. See also GroupCreateRoleAsync, GroupDeleteRoleAsync. When the asynchronous task is complete, call [PFGroupsUpdateRoleGetResultSize](/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdaterolegetresultsize) and [PFGroupsUpdateRoleGetResult](/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdaterolegetresult) to get the result.

## Requirements

**Header:** PFGroups.h

## See also

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


## Related topics

- [PFGroupsUpdateRoleGetResult](/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdaterolegetresult.md)
- [Services C API overview - PFGroups.h](/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsUpdateGroupAsync](/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdategroupasync.md)
- [PFGroupsUpdateGroupRoleRequest](/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprolerequest.md)
- [PFGroupsUpdateRoleGetResultSize](/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdaterolegetresultsize.md)