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

# PFGroupsChangeMemberRoleRequest

> PFGroupsChangeMemberRoleRequest 資料模型。在單一作業中將實體清單的角色成員資格從某個角色變更為另一個角色。

PFGroupsChangeMemberRoleRequest 資料模型。在單一作業中將實體清單的角色成員資格從某個角色變更為另一個角色。目的地角色必須已存在。這相當於將實體新增至目的地角色並從來源角色中移除。成功時不傳回任何內容。

## 語法

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

### 成員

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

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

**`customTagsCount`**   uint32\_t

customTags 的計數

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

（選擇性）實體將成為其成員的角色識別碼。這必須是現有的角色。角色識別碼的長度必須介於 1 到 64 個字元之間。

**`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\*

要在群組中的角色之間移動的實體清單。此清單中的所有實體都必須是群組和來源角色的成員。

**`membersCount`**   uint32\_t

members 的計數

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

實體目前所屬角色的識別碼。角色識別碼的長度必須介於 1 到 64 個字元之間。

## 需求

**標頭：** PFGroupsTypes.h

## 另請參閱

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


## Related topics

- [PFGroupsChangeMemberRoleAsync](/zh-TW/services/playfab/api-references/c/pfgroups/functions/pfgroupschangememberroleasync.md)
- [服務 C API 概觀 - PFGroupsTypes.h](/zh-TW/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [Change Member Role](/api-reference/groups/change-member-role.md)
- [Is Member](/api-reference/groups/is-member.md)
- [List Group Members](/api-reference/groups/list-group-members.md)