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

# PFProfilesGetProfileAsync

> 표시 이름, 아바타, 통계, 지정된 엔터티 키와 연결된 개체 등 단일 엔터티에 대한 PlayFab 엔터티 프로필을 검색합니다.

엔터티의 프로필을 검색합니다.

## 구문

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

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

**`request`**   [PFProfilesGetEntityProfileRequest\*](/services/playfab/api-references/c/pfprofilestypes/structs/pfprofilesgetentityprofilerequest)

값이 채워진 요청 개체입니다.

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

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

### 반환 값

Type: HRESULT

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

## 설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. 엔터티 유형과 엔터티 식별자를 지정하면 엔터티 저장소에서 프로필을 검색합니다. 검색되는 프로필이 호출자의 것이라면 읽기 작업은 일관성 있는 읽기가 되고, 그렇지 않다면 일관성 없는 읽기가 됩니다. 일관성 없는 읽기란 프로필을 읽기 전에 커밋된 모든 쓰기가 반영되었음을 보장하지 않으므로 오래된 읽기가 발생할 수 있음을 의미합니다. 일관성이 중요하다면 결과의 Version Number를 사용해 각 판독자가 갖고 있는 프로필의 버전을 비교할 수 있습니다. 비동기 작업이 완료되면 [PFProfilesGetProfileGetResultSize](/services/playfab/api-references/c/pfprofiles/functions/pfprofilesgetprofilegetresultsize)와 [PFProfilesGetProfileGetResult](/services/playfab/api-references/c/pfprofiles/functions/pfprofilesgetprofilegetresult)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFProfiles.h

## 참고 항목

[PFProfiles 멤버](/services/playfab/api-references/c/pfprofiles/pfprofiles_members)


## Related topics

- [PFProfilesGetProfileGetResult](/ko/services/playfab/api-references/c/pfprofiles/functions/pfprofilesgetprofilegetresult.md)
- [Services C API 개요 - PFProfiles.h](/ko/services/playfab/api-references/c/pfprofiles/pfprofiles_members.md)
- [PlayFab Unified SDK에서 비동기 호출 수행](/ko/services/playfab/sdks/unified-sdk/async-model.md)
- [비동기 호출 만들기](/ko/services/playfab/sdks/c/async.md)
- [PFProfilesGetProfilesAsync](/ko/services/playfab/api-references/c/pfprofiles/functions/pfprofilesgetprofilesasync.md)