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

# PFPlayerDataManagementServerUpdateUserDataAsync

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

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

## 語法

```cpp theme={null}
HRESULT PFPlayerDataManagementServerUpdateUserDataAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFPlayerDataManagementServerUpdateUserDataRequest* request,  
    XAsyncBlock* async  
)  
```

### 參數

**`titleEntityHandle`**   PFEntityHandle

使用 PFAuthenticationGetEntityWithSecretKeyAsync 取得之遊戲 Entity 的 PFEntityHandle。

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

已填入的要求物件。

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

用於非同步作業的 XAsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。

## 備註

此 API 可在 Win32、Linux 和 macOS 上使用。此函式會對包含使用者自訂資料的任意 JSON 物件執行累加式更新。更新自訂資料物件時，物件中已存在的索引鍵其值會遭到覆寫，而值為 null 的索引鍵將會移除。除了呼叫中指定的索引鍵/值組之外，不會變更其他任何索引鍵/值組。另請參閱 ServerGetUserDataAsync、ServerGetUserInternalDataAsync、ServerGetUserReadOnlyDataAsync、ServerUpdateUserInternalDataAsync、ServerUpdateUserReadOnlyDataAsync。非同步工作完成時，請呼叫 [PFPlayerDataManagementServerUpdateUserDataGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserdatagetresult) 以取得結果。

## 需求

**標頭：** PFPlayerDataManagement.h

## 另請參閱

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


## Related topics

- [PFPlayerDataManagementServerUpdateUserDataGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserdatagetresult.md)
- [服務 C API 概觀 - PFPlayerDataManagement.h](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members.md)
- [PFPlayerDataManagementServerUpdateUserInternalDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserinternaldataasync.md)
- [PFPlayerDataManagementServerUpdateUserPublisherDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateuserpublisherdataasync.md)
- [PFPlayerDataManagementServerGetUserDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementservergetuserdataasync.md)