> ## 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\*](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientupdateplayercustompropertiesrequest)

已填充的请求对象。

**`async`**   XAsyncBlock\*<br />*Inout*

用于异步操作的 XAsyncBlock。

### 返回值

类型：HRESULT

此 API 操作的结果代码。

## 备注

此 API 可在所有平台上使用。对指定玩家的自定义属性执行增量更新。更新玩家的自定义属性时，已存在属性的值将被覆盖。除调用中指定的属性外，不会更改其他任何属性。另请参阅 ClientDeletePlayerCustomPropertiesAsync、ClientGetPlayerCustomPropertyAsync、ClientListPlayerCustomPropertiesAsync。异步任务完成后，调用 [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesGetResult](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesgetresult) 获取结果。

## 要求

**头文件：** PFPlayerDataManagement.h

## 另请参阅

[PFPlayerDataManagement 成员](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members)


## Related topics

- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesGetResult](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesgetresult.md)
- [PFPlayerDataManagementClientListPlayerCustomPropertiesAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientlistplayercustompropertiesasync.md)
- [PFPlayerDataManagementClientGetPlayerCustomPropertyAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetplayercustompropertyasync.md)
- [PFPlayerDataManagementClientDeletePlayerCustomPropertiesAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientdeleteplayercustompropertiesasync.md)
- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesResult](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientupdateplayercustompropertiesresult.md)