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

# PFPlayerDataManagementClientUpdateUserDataRequest

> PFPlayerDataManagementClientUpdateUserDataRequest 資料模型。此函式會對包含自訂資料的任意字串執行累加式更新。

PFPlayerDataManagementClientUpdateUserDataRequest 資料模型。此函式會對包含使用者自訂資料的任意字串執行累加式更新。更新自訂資料物件時，物件中已存在之索引鍵的值會被覆寫，而值為 null 的索引鍵則會被移除。新的索引鍵會以指定的值新增。除了呼叫中指定的索引鍵/值組之外，不會變更其他索引鍵/值組。

## 語法

```cpp theme={null}
typedef struct PFPlayerDataManagementClientUpdateUserDataRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFStringDictionaryEntry const* data;  
    uint32_t dataCount;  
    const char* const* keysToRemove;  
    uint32_t keysToRemoveCount;  
    PFUserDataPermission const* permission;  
} PFPlayerDataManagementClientUpdateUserDataRequest;  
```

### 成員

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

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

**`customTagsCount`**   uint32\_t

customTags 的計數

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

（選擇性）要寫入自訂資料的索引鍵/值組。請注意，索引鍵會修剪空白字元、大小有限制，且不得以 '!' 字元開頭或為 null。

**`dataCount`**   uint32\_t

data 的計數

**`keysToRemove`**   const char\* const\*<br />*may be nullptr*

（選擇性）要從 UserData 移除之 Data 索引鍵的選擇性清單。由於語言限制，某些 SDK 無法將 null 值插入 Data。請使用此項目直接刪除索引鍵。

**`keysToRemoveCount`**   uint32\_t

keysToRemove 的計數

**`permission`**   [PFUserDataPermission](/zh-TW/services/playfab/api-references/c/pftypes/enums/pfuserdatapermission) const\*<br />*may be nullptr*

（選擇性）要套用至此要求中寫入之所有使用者資料索引鍵的權限。若未設定，預設為 "private"。這用於某位玩家要求另一位玩家之資訊的情況；這類要求只會傳回 Public 索引鍵。

## 需求

**標頭：** PFPlayerDataManagementTypes.h

## 另請參閱

[PFPlayerDataManagementTypes 成員](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members)


## Related topics

- [PFPlayerDataManagementClientUpdateUserDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserdataasync.md)
- [PFPlayerDataManagementClientUpdateUserPublisherDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserpublisherdataasync.md)
- [服務 C API 概觀 - PFPlayerDataManagementTypes.h](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)
- [PFPlayerDataManagementUpdateUserInternalDataRequest](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementupdateuserinternaldatarequest.md)
- [PFPlayerDataManagementServerUpdateUserDataRequest](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateuserdatarequest.md)