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

> Crea un nuevo rol de grupo.

Crea un nuevo rol de grupo.

## Sintaxis

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

### Parámetros

**`entityHandle`**   PFEntityHandle

PFEntityHandle que se usará para la autenticación.

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

Objeto de solicitud rellenado.

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

XAsyncBlock para la operación asincrónica.

### Valor devuelto

Tipo: HRESULT

Código de resultado de esta operación de API.

## Comentarios

Esta API está disponible en todas las plataformas. Crea un nuevo rol dentro de un grupo existente, sin miembros. Tanto el identificador del rol como el nombre del rol deben ser únicos dentro del grupo, pero el nombre puede ser igual que el identificador. El identificador del rol se establece en el momento de la creación y no se puede cambiar. Devuelve información sobre el rol que se creó. Consulte también GroupDeleteRoleAsync. Cuando se complete la tarea asincrónica, llame a [PFGroupsCreateRoleGetResultSize](/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresultsize) y a [PFGroupsCreateRoleGetResult](/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult) para obtener el resultado.

## Requisitos

**Encabezado:** PFGroups.h

## Consulte también

[Miembros de PFGroups](/services/playfab/api-references/c/pfgroups/pfgroups_members)


## Related topics

- [PFGroupsCreateRoleGetResult](/es/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult.md)
- [Información general de la API de C de Services - PFGroups.h](/es/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsUpdateRoleAsync](/es/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)
- [PFGroupsDeleteRoleAsync](/es/services/playfab/api-references/c/pfgroups/functions/pfgroupsdeleteroleasync.md)
- [PFGroupsCreateGroupAsync](/es/services/playfab/api-references/c/pfgroups/functions/pfgroupscreategroupasync.md)