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

# PFGroupsCreateGroupRoleRequest

> Modelo de dados de PFGroupsCreateGroupRoleRequest. Cria uma nova função em um grupo existente, sem membros. Tanto a ID quanto o nome da função devem ser exclusivos dentro.

Modelo de dados de PFGroupsCreateGroupRoleRequest. Cria uma nova função em um grupo existente, sem membros. Tanto a ID quanto o nome da função devem ser exclusivos dentro do grupo, mas o nome pode ser igual à ID. A ID da função é definida na criação e não pode ser alterada. Retorna informações sobre a função que foi criada.

## Sintaxe

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

### Membros

**`customTags`**   [PFStringDictionaryEntry](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*may be nullptr*

(Opcional) As marcas personalizadas opcionais associadas à solicitação (por exemplo, número de build, identificadores de rastreamento externos etc.).

**`customTagsCount`**   uint32\_t

Contagem de customTags

**`group`**   [PFEntityKey](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*

O identificador do grupo.

**`roleId`**   const char\*\
*is null-terminated*

A ID da função. Deve ser exclusiva dentro do grupo e não pode ser alterada. As IDs de função devem ter entre 1 e 64 caracteres e estão restritas a a-Z, A-Z, 0-9, '(', ')', '\_', '-' e '.'.

**`roleName`**   const char\*\
*is null-terminated*

O nome da função. Deve ser exclusivo dentro do grupo e pode ser alterado posteriormente. Os nomes de função devem ter entre 1 e 100 caracteres.

## Requisitos

**Cabeçalho:** PFGroupsTypes.h

## Confira também

[Membros de PFGroupsTypes](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)


## Related topics

- [PFGroupsCreateRoleAsync](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupscreateroleasync.md)
- [Visão geral da API C do Services - PFGroupsTypes.h](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsCreateGroupRoleResponse](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouproleresponse.md)
- [PFGroupsUpdateGroupRoleRequest](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprolerequest.md)
- [PFGroupsCreateRoleGetResult](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult.md)