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

# PFGroupsAddMembersAsync

> メンバーをグループまたはロールに追加します。

メンバーをグループまたはロールに追加します。

## 構文

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

### パラメーター

**`entityHandle`**   PFEntityHandle

認証に使用する PFEntityHandle。

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

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

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

非同期操作用の XAsyncBlock。

### 戻り値

型: HRESULT

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

## 解説

この API はすべてのプラットフォームで利用できます。メンバーをグループまたはロールに追加します。グループの既存メンバーはグループ内のロールに追加されますが、ユーザーがまだグループのメンバーでない場合は、タイトル要求者のみがそのユーザーをグループに追加できます。それ以外は、グループへの応募または招待システムを使用して新しいメンバーをグループに追加する必要があります。成功時には何も返されません。GroupApplyToGroupAsync、GroupInviteToGroupAsync、GroupListGroupMembersAsync、GroupRemoveMembersAsync も参照してください。操作の状態を取得するには XAsyncGetStatus を呼び出します。サービス呼び出しが失敗した場合、非同期処理の結果は E\_PF\_ROLE\_DOES\_NOT\_EXIST またはグローバル PlayFab サービス エラーのいずれかになります。エラー処理の詳細については、ドキュメント ページ「Handling PlayFab Errors」を参照してください。

## 要件

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

## 関連項目

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


## Related topics

- [Services C API overview - PFGroups.h](/ja-jp/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [PFGroupsRemoveMembersAsync](/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsremovemembersasync.md)
- [PFGroupsAddMembersRequest](/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsaddmembersrequest.md)
- [PFGroupsChangeMemberRoleAsync](/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [PFGroupsIsMemberAsync](/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsismemberasync.md)