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

# PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest

> PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest 資料模型。對指定玩家的自訂屬性執行累加式更新。更新玩家的自訂屬性時，已存在之屬性的值會被覆寫。除了呼叫中指定的屬性之外，不會變更其他屬性。

PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest 資料模型。對指定玩家的自訂屬性執行累加式更新。更新玩家的自訂屬性時，已存在之屬性的值會被覆寫。除了呼叫中指定的屬性之外，不會變更其他屬性。

## 語法

```cpp theme={null}
typedef struct PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    int32_t const* expectedPropertiesVersion;  
    PFPlayerDataManagementUpdateProperty const* properties;  
    uint32_t propertiesCount;  
} PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest;  
```

### 成員

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

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

**`customTagsCount`**   uint32\_t

customTags 的計數

**`expectedPropertiesVersion`**   int32\_t const\*<br />*may be nullptr*

（選擇性）用於並行控制的選擇性欄位。可藉此確保只有在玩家的屬性自上一個版本以來未被任何其他用戶端更新時，才會執行更新作業。

**`properties`**   [PFPlayerDataManagementUpdateProperty](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementupdateproperty) const\*

要為玩家設定的屬性集合。

**`propertiesCount`**   uint32\_t

properties 的計數

## 需求

**標頭：** PFPlayerDataManagementTypes.h

## 另請參閱

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


## Related topics

- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesasync.md)
- [服務 C API 概觀 - PFPlayerDataManagementTypes.h](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)
- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientupdateplayercustompropertiesresult.md)
- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesgetresult.md)
- [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesRequest](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateplayercustompropertiesrequest.md)