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

# PFGroupsInviteToGroupAsync

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

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

## 構文

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

### パラメーター

**`entityHandle`**   PFEntityHandle

認証に使用する PFEntityHandle。

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

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

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

非同期操作用の XAsyncBlock。

### 戻り値

型: HRESULT

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

## 解説

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

## 要件

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

## 関連項目

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


## Related topics

- [PFGroupsInviteToGroupGetResult](/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresult.md)
- [Services C API overview - PFGroups.h](/ja-jp/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsInviteToGroupGetResultSize](/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsinvitetogroupgetresultsize.md)
- [PFGroupsInviteToGroupResponse](/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogroupresponse.md)
- [PFGroupsInviteToGroupRequest](/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogrouprequest.md)