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

# PFGroupsAddMembersRequest

> PFGroupsAddMembersRequest 資料模型。將成員新增至群組或角色。群組的現有成員會新增至群組內的角色，但如果使用者。

PFGroupsAddMembersRequest 資料模型。將成員新增至群組或角色。群組的現有成員會新增至群組內的角色，但如果使用者尚未成為群組成員，則只有 Title 宣告者可以將其新增至群組，其他人則必須使用群組申請或邀請系統將新成員新增至群組。成功時不傳回任何內容。

## 語法

```cpp theme={null}
typedef struct PFGroupsAddMembersRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* group;  
    PFEntityKey const* members;  
    uint32_t membersCount;  
    const char* roleId;  
} PFGroupsAddMembersRequest;  
```

### 成員

**`customTags`**   [PFStringDictionaryEntry](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

（選擇性）與要求相關聯的選擇性自訂標籤（例如組建編號、外部追蹤識別碼等）。

**`customTagsCount`**   uint32\_t

customTags 的計數

**`group`**   [PFEntityKey](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

群組的識別碼。

**`members`**   [PFEntityKey](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

要新增至群組的實體清單。只有類型為 title\_player\_account 和 character 的實體可以新增至群組。

**`membersCount`**   uint32\_t

members 的計數

**`roleId`**   const char\*<br />*is null-terminated*

（選擇性）選擇性：要將實體新增至的現有角色識別碼。如果未指定，將會使用群組的預設成員角色。角色識別碼的長度必須介於 1 到 64 個字元之間。

## 需求

**標頭：** PFGroupsTypes.h

## 另請參閱

[PFGroupsTypes 成員](/zh-TW/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

- [PFGroupsAddMembersAsync](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupsaddmembersasync.md)
- [服務 C API 概觀 - PFGroupsTypes.h](/zh-TW/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [Add Shared Group Members](/api-reference/shared-group-data/add-shared-group-members.md)
- [PFGroupsIsMemberRequest](/zh-TW/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsismemberrequest.md)
- [PFGroupsListGroupMembersRequest](/zh-TW/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupmembersrequest.md)