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

# PFPlayerDataManagementClientUpdateUserDataAsync

> 建立並更新使用者的遊戲專屬自訂資料，此資料可由用戶端讀取和寫入

建立並更新使用者的遊戲專屬自訂資料，此資料可由用戶端讀取和寫入

## 語法

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

### 參數

**`entityHandle`**   PFEntityHandle

用於驗證的 PFEntityHandle。

**`request`**   [PFPlayerDataManagementClientUpdateUserDataRequest\*](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientupdateuserdatarequest)

已填入的要求物件。

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

用於非同步作業的 XAsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。

## 備註

此 API 適用於所有平台。此函式會對包含使用者自訂資料的任意字串執行累加式更新。更新自訂資料物件時，物件中已存在的索引鍵的值會被覆寫，而值為 null 的索引鍵則會被移除。新的索引鍵將以指定的值新增。除了呼叫中指定的索引鍵/值組之外，不會變更其他任何索引鍵/值組。另請參閱 ClientGetUserDataAsync、ClientGetUserReadOnlyDataAsync。非同步工作完成時，請呼叫 [PFPlayerDataManagementClientUpdateUserDataGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserdatagetresult) 以取得結果。

## 需求

**標頭：** PFPlayerDataManagement.h

## 另請參閱

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


## Related topics

- [PFPlayerDataManagementClientUpdateUserDataGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserdatagetresult.md)
- [服務 C API 概觀 - PFPlayerDataManagement.h](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members.md)
- [PFPlayerDataManagementClientUpdateUserPublisherDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserpublisherdataasync.md)
- [PFPlayerDataManagementClientUpdateUserPublisherDataGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserpublisherdatagetresult.md)
- [PFPlayerDataManagementClientGetUserPublisherDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetuserpublisherdataasync.md)