> ## 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\*](/zh-TW/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 成員](/zh-TW/services/playfab/api-references/c/pfgroups/pfgroups_members)


## Related topics

- [服務 C API 概觀 - PFGroups.h](/zh-TW/services/playfab/api-references/c/pfgroups/pfgroups_members.md)
- [Add Shared Group Members](/api-reference/shared-group-data/add-shared-group-members.md)
- [PFGroupsRemoveMembersAsync](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupsremovemembersasync.md)
- [PFGroupsChangeMemberRoleAsync](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [PFGroupsAddMembersRequest](/zh-TW/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsaddmembersrequest.md)