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

# PFGroupsInviteToGroupAsync

> プレイヤーをグループへの参加に招待します

プレイヤーをグループへの参加に招待します

## 構文

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

### パラメーター

**`entityHandle`**   PFEntityHandle

認証に使用する PFEntityHandle。

**`request`**   [PFGroupsInviteToGroupRequest\*](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogrouprequest.md)

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

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

非同期操作用の XAsyncBlock。

### 戻り値

型: HRESULT

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

## 解説

この API はすべてのプラットフォームで利用できます。プレイヤーがグループにブロックされていない場合、そのプレイヤーをグループへの参加に招待します。任意のロールを指定すると、プレイヤーが招待を承諾したときに自動的にそのロールに割り当てることができます。既定では、エンティティにグループへの参加申請が未処理で存在する場合、代わりに申請を承諾し、その旨を示すエラーを返します。これにより、後でクリーンアップが必要な参加招待の重複作成を防ぎます。新しい招待に関する情報、または既存の参加申請が承諾されたことを示すエラーが返されます。GroupAcceptGroupInvitationAsync、GroupListGroupInvitationsAsync、GroupListMembershipOpportunitiesAsync、GroupRemoveGroupInvitationAsync も参照してください。非同期タスクが完了したら、[PFGroupsInviteToGroupGetResultSize](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresultsize.md) と [PFGroupsInviteToGroupGetResult](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresult.md) を呼び出して結果を取得します。

## 要件

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

## 関連項目

[PFGroups のメンバー](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/pfgroups_members.md)


## Related topics

- [PFGroupsInviteToGroupGetResult](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresult.md)
- [Services C API overview - PFGroups.h](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [Invite To Group](https://docs.xbox.com/api-reference/groups/invite-to-group.md)
- [PFGroupsInviteToGroupGetResultSize](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresultsize.md)
- [PFGroupsInviteToGroupResponse](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogroupresponse.md)