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

# PFGroupsCreateGroupRoleRequest

> Modèle de données PFGroupsCreateGroupRoleRequest. 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.

Modèle de données PFGroupsCreateGroupRoleRequest. 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 à la création et ne peut pas être modifié. Retourne des renseignements sur le rôle qui a été créé.

## Syntaxe

```cpp theme={null}
typedef struct PFGroupsCreateGroupRoleRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* group;  
    const char* roleId;  
    const char* roleName;  
} PFGroupsCreateGroupRoleRequest;  
```

### Membres

**`customTags`**   [PFStringDictionaryEntry](/fr-CA/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(Facultatif) Les balises personnalisées facultatives associées à la requête (p. ex. numéro de build, identificateurs de trace externes, etc.).

**`customTagsCount`**   uint32\_t

Nombre de customTags

**`group`**   [PFEntityKey](/fr-CA/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

L'identificateur du groupe.

**`roleId`**   const char\*<br />*is null-terminated*

L'ID du rôle. Il doit être unique au sein du groupe et ne peut pas être modifié. Les ID de rôle doivent comporter entre 1 et 64 caractères et sont limités à a-Z, A-Z, 0-9, '(', ')', '\_', '-' et '.'.

**`roleName`**   const char\*<br />*is null-terminated*

Le nom du rôle. Il doit être unique au sein du groupe et peut être modifié ultérieurement. Les noms de rôle doivent comporter entre 1 et 100 caractères.

## Configuration requise

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

## Voir aussi

[Membres de PFGroupsTypes](/fr-CA/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

- [PFGroupsCreateRoleAsync](/fr-CA/services/playfab/api-references/c/pfgroups/functions/pfgroupscreateroleasync.md)
- [Vue d'ensemble de l'API C Services - PFGroupsTypes.h](/fr-CA/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsCreateGroupRequest](/fr-CA/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprequest.md)
- [PFGroupsCreateGroupRoleResponse](/fr-CA/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouproleresponse.md)
- [PFGroupsUpdateGroupRoleRequest](/fr-CA/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprolerequest.md)