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

# PFPlayerDataManagementClientGetUserDataAsync

> Player Data Management에서 인증된 PlayFab 플레이어에 대해 클라이언트가 읽고 쓸 수 있는 타이틀별 사용자 지정 사용자 데이터를 검색하는 Client API입니다.

클라이언트가 읽고 쓸 수 있는 사용자의 타이틀별 사용자 지정 데이터를 검색합니다.

## 구문

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

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

비동기 작업을 위한 XAsyncBlock입니다.

### 반환 값

형식: HRESULT

이 API 작업의 결과 코드입니다.

## 설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. 데이터는 JSON 키-값 쌍으로 저장됩니다. 어떤 원본을 통해서든 데이터가 업데이트될 때마다 버전 카운터가 증가합니다. Version 매개 변수가 제공되면 이 호출은 시스템의 현재 버전이 제공된 값보다 큰 경우에만 데이터를 반환합니다. Keys 매개 변수가 제공되면 반환되는 데이터 개체에는 지정된 Keys에 해당하는 데이터만 포함됩니다. 그렇지 않으면 전체 사용자 지정 사용자 데이터 집합이 반환됩니다. ClientGetUserReadOnlyDataAsync, ClientUpdateUserDataAsync도 참조하세요. 비동기 작업이 완료되면 [PFPlayerDataManagementClientGetUserDataGetResultSize](/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetuserdatagetresultsize) 및 [PFPlayerDataManagementClientGetUserDataGetResult](/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetuserdatagetresult)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFPlayerDataManagement.h

## 참고 항목

[PFPlayerDataManagement 멤버](/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members)


## Related topics

- [PFPlayerDataManagementClientGetUserDataGetResult](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetuserdatagetresult.md)
- [Services C API 개요 - PFPlayerDataManagement.h](/ko/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members.md)
- [PFPlayerDataManagementClientGetUserPublisherDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetuserpublisherdataasync.md)
- [PFPlayerDataManagementClientUpdateUserDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserdataasync.md)
- [PFPlayerDataManagementClientGetUserReadOnlyDataAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetuserreadonlydataasync.md)