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

# PFPlayerDataManagementServerUpdatePlayerCustomPropertiesRequest

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

PFPlayerDataManagementServerUpdatePlayerCustomPropertiesRequest 資料模型。以累加方式更新指定玩家的自訂屬性。更新玩家的自訂屬性時，已存在的屬性其值會被覆寫。除了呼叫中指定的屬性外，不會變更其他任何屬性。

## 語法

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

### 成員

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

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

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

PlayFab 指派給要執行此作業之使用者的唯一識別碼。

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

- [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateplayercustompropertiesasync.md)
- [服務 C API 概觀 - PFPlayerDataManagementTypes.h](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)
- [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateplayercustompropertiesresult.md)
- [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateplayercustompropertiesgetresult.md)
- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientupdateplayercustompropertiesrequest.md)