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

> 新しいグループ ロールを作成します。

新しいグループ ロールを作成します。

## 構文

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

### パラメーター

**`entityHandle`**   PFEntityHandle

認証に使用する PFEntityHandle。

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

値が設定されたリクエスト オブジェクト。

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

非同期操作用の XAsyncBlock。

### 戻り値

型: HRESULT

この API 操作の結果コード。

## 解説

この API はすべてのプラットフォームで利用できます。既存のグループ内に、メンバーがいない新しいロールを作成します。ロール ID とロール名の両方がグループ内で一意である必要がありますが、名前を ID と同じにすることは可能です。ロール ID は作成時に設定され、変更することはできません。作成されたロールに関する情報が返されます。GroupDeleteRoleAsync も参照してください。非同期タスクが完了したら、[PFGroupsCreateRoleGetResultSize](/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresultsize) と [PFGroupsCreateRoleGetResult](/services/playfab/api-references/c/pfgroups/functions/pfgroupscreaterolegetresult) を呼び出して結果を取得します。

## 要件

**ヘッダー:** PFGroups.h

## 関連項目

[PFGroups のメンバー](/services/playfab/api-references/c/pfgroups/pfgroups_members)


## Related topics

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