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

> 새 그룹 역할을 만듭니다.

새 그룹 역할을 만듭니다.

## Syntax

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

### Parameters

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

비동기 작업을 위한 XAsyncBlock입니다.

### Return value

Type: HRESULT

이 API 작업의 결과 코드입니다.

## Remarks

이 API는 모든 플랫폼에서 사용할 수 있습니다. 기존 그룹 내에 멤버가 없는 새 역할을 만듭니다. 역할 ID와 역할 이름은 모두 그룹 내에서 고유해야 하지만, 이름은 ID와 동일할 수 있습니다. 역할 ID는 생성 시 설정되며 변경할 수 없습니다. 생성된 역할에 대한 정보를 반환합니다. 관련 항목: GroupDeleteRoleAsync. 비동기 작업이 완료되면 [PFGroupsCreateRoleGetResultSize](/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresultsize) 및 [PFGroupsCreateRoleGetResult](/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult)를 호출하여 결과를 가져옵니다.

## Requirements

**Header:** PFGroups.h

## See also

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


## Related topics

- [PFGroupsCreateRoleGetResult](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult.md)
- [Services C API overview - PFGroups.h](/ko/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsUpdateRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsupdateroleasync.md)
- [PFGroupsDeleteRoleAsync](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupsdeleteroleasync.md)
- [PFGroupsCreateRoleGetResultSize](/ko/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresultsize.md)