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

> 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](/pt-BR/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*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](/pt-BR/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

O identificador do grupo.

**`roleId`**   const char\*<br />*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\*<br />*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](/pt-BR/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

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