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

# PFGroupsCreateRoleAsync

> Cria uma nova função de grupo.

Cria uma nova função de grupo.

## Sintaxe

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

### Parâmetros

**`entityHandle`**   PFEntityHandle

PFEntityHandle a ser usado para autenticação.

**`request`**   [PFGroupsCreateGroupRoleRequest\*](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md)

Objeto de solicitação preenchido.

**`async`**   XAsyncBlock\*\
*Inout*

XAsyncBlock para a operação assíncrona.

### Valor de retorno

Tipo: HRESULT

Código de resultado desta operação de API.

## Comentários

Esta API está disponível em todas as plataformas. Cria uma nova função dentro de 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. Consulte também GroupDeleteRoleAsync. Quando a tarefa assíncrona for concluída, chame [PFGroupsCreateRoleGetResultSize](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresultsize.md) e [PFGroupsCreateRoleGetResult](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult.md) para obter o resultado.

## Requisitos

**Cabeçalho:** PFGroups.h

## Confira também

[Membros de PFGroups](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/pfgroups_members.md)


## Related topics

- [PFGroupsCreateRoleGetResult](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult.md)
- [Visão geral da API C do Services - PFGroups.h](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsUpdateRoleAsync](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)
- [PFGroupsDeleteRoleAsync](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroups/functions/pfgroupsdeleteroleasync.md)
- [PFGroupsCreateGroupRoleResponse](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouproleresponse.md)