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

# PFPlayerDataManagementServerGetUserDataAsync

> 伺服器 API，為指定的 PlayFab 玩家擷取可由用戶端讀取和寫入的遊戲專屬自訂使用者資料，可從受信任的遊戲伺服器呼叫。

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

## 語法

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

### 參數

**`titleEntityHandle`**   PFEntityHandle

使用 PFAuthenticationGetEntityWithSecretKeyAsync 取得的遊戲實體的 PFEntityHandle。

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

已填入的要求物件。

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

用於非同步作業的 XAsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。

## 備註

此 API 適用於 Win32、Linux 和 macOS。資料會以 JSON 索引鍵/值組的形式儲存。如果提供 Keys 參數，傳回的資料物件只會包含所指定 Keys 的專屬資料。否則，將傳回完整的自訂使用者資料集。另請參閱 ServerGetUserInternalDataAsync、ServerGetUserReadOnlyDataAsync、ServerUpdateUserDataAsync、ServerUpdateUserInternalDataAsync、ServerUpdateUserReadOnlyDataAsync。非同步工作完成時，請呼叫 [PFPlayerDataManagementServerGetUserDataGetResultSize](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementservergetuserdatagetresultsize) 和 [PFPlayerDataManagementServerGetUserDataGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementservergetuserdatagetresult) 以取得結果。

## 需求

**標頭：** PFPlayerDataManagement.h

## 另請參閱

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


## Related topics

- [PFPlayerDataManagementServerGetUserDataGetResult](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementservergetuserdatagetresult.md)
- [服務 C API 概觀 - PFPlayerDataManagement.h](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members.md)
- [PFPlayerDataManagementServerGetUserInternalDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementservergetuserinternaldataasync.md)
- [PFPlayerDataManagementServerGetUserPublisherDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementservergetuserpublisherdataasync.md)
- [PFPlayerDataManagementServerGetUserReadOnlyDataAsync](/zh-TW/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementservergetuserreadonlydataasync.md)