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

# PFPlayerDataManagementClientUpdatePlayerCustomPropertiesAsync

> 用戶端 API，對玩家的自訂屬性執行累加式更新。現有屬性會被覆寫，未指定的屬性則維持不變。

更新玩家的遊戲專屬自訂屬性值

## 語法

```cpp theme={null}
HRESULT PFPlayerDataManagementClientUpdatePlayerCustomPropertiesAsync(  
    PFEntityHandle entityHandle,  
    const PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest* request,  
    XAsyncBlock* async  
)  
```

### 參數

**`entityHandle`**   PFEntityHandle

用於驗證的 PFEntityHandle。

**`request`**   [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest\*](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientupdateplayercustompropertiesrequest.md)

已填入的要求物件。

**`async`**   XAsyncBlock\*\
*Inout*

用於非同步作業的 XAsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。

## 備註

此 API 適用於所有平台。對指定玩家的自訂屬性執行累加式更新。更新玩家的自訂屬性時，已存在的屬性的值會被覆寫。除了呼叫中指定的屬性之外，不會變更其他任何屬性。另請參閱 ClientDeletePlayerCustomPropertiesAsync、ClientGetPlayerCustomPropertyAsync、ClientListPlayerCustomPropertiesAsync。非同步工作完成時，請呼叫 [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesGetResult](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesgetresult.md) 以取得結果。

## 需求

**標頭：** PFPlayerDataManagement.h

## 另請參閱

[PFPlayerDataManagement 成員](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members.md)


## Related topics

- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesGetResult](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesgetresult.md)
- [服務 C API 概觀 - PFPlayerDataManagement.h](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members.md)
- [PFPlayerDataManagementClientListPlayerCustomPropertiesAsync](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientlistplayercustompropertiesasync.md)
- [PFPlayerDataManagementClientGetPlayerCustomPropertyAsync](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetplayercustompropertyasync.md)
- [PFPlayerDataManagementClientDeletePlayerCustomPropertiesAsync](https://devdocs.xbox.com/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientdeleteplayercustompropertiesasync.md)