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

# PFGroupsCreateRoleAsync

> Crée un nouveau rôle de groupe.

Crée un nouveau rôle de groupe.

## Syntaxe

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

### Paramètres

**`entityHandle`**   PFEntityHandle

PFEntityHandle à utiliser pour l'authentification.

**`request`**   [PFGroupsCreateGroupRoleRequest\*](/fr-CA/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest)

Objet de requête rempli.

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

XAsyncBlock pour l'opération asynchrone.

### Valeur de retour

Type : HRESULT

Code de résultat de cette opération d'API.

## Notes

Cette API est disponible sur toutes les plateformes. Crée un nouveau rôle sans membres au sein d'un groupe existant. L'ID et le nom du rôle doivent tous deux être uniques au sein du groupe, mais le nom peut être identique à l'ID. L'ID du rôle est défini lors de la création et ne peut pas être modifié. Retourne des informations sur le rôle créé. Voir aussi GroupDeleteRoleAsync. Une fois la tâche asynchrone terminée, appelez [PFGroupsCreateRoleGetResultSize](/fr-CA/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresultsize) et [PFGroupsCreateRoleGetResult](/fr-CA/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult) pour obtenir le résultat.

## Configuration requise

**En-tête :** PFGroups.h

## Voir aussi

[Membres de PFGroups](/fr-CA/services/playfab/api-references/c/pfgroups/pfgroups_members)


## Related topics

- [PFGroupsCreateRoleGetResult](/fr-CA/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult.md)
- [Vue d'ensemble de l'API C Services - PFGroups.h](/fr-CA/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsUpdateRoleAsync](/fr-CA/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)
- [PFGroupsDeleteRoleAsync](/fr-CA/services/playfab/api-references/c/pfgroups/functions/pfgroupsdeleteroleasync.md)
- [PFGroupsCreateGroupAsync](/fr-CA/services/playfab/api-references/c/pfgroups/functions/pfgroupscreategroupasync.md)