> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*may be nullptr*

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

**`customTagsCount`**   uint32\_t

customTags 的計數

**`expectedPropertiesVersion`**   int32\_t const\*\
*may be nullptr*

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

**`playFabId`**   const char\*\
*is null-terminated*

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

**`properties`**   [PFPlayerDataManagementUpdateProperty](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementupdateproperty.md) const\*

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

**`propertiesCount`**   uint32\_t

properties 的計數

## 需求

**標頭：** PFPlayerDataManagementTypes.h

## 另請參閱

[PFPlayerDataManagementTypes 成員](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)


## Related topics

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