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

### 返回值

类型：HRESULT

此 API 操作的结果代码。

## 备注

此 API 可在所有平台上使用。给定实体类型和实体标识符，将从实体存储中检索个人资料。如果检索的个人资料是调用方自己的，则读取操作是一致的；否则为不一致读取。不一致读取意味着我们不保证在读取个人资料之前所有提交的写入都已发生，可能会读取到陈旧数据。如果一致性很重要，可以使用结果上的版本号来比较任何读取方拥有的个人资料版本。异步任务完成后，调用 [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](/zh-CN/services/playfab/api-references/c/pfprofiles/functions/pfprofilesgetprofilegetresult.md)
- [Services C API overview - PFProfiles.h](/zh-CN/services/playfab/api-references/c/pfprofiles/pfprofiles_members.md)
- [在 PlayFab 统一 SDK 中进行异步调用](/zh-CN/services/playfab/sdks/unified-sdk/async-model.md)
- [进行异步调用](/zh-CN/services/playfab/sdks/c/async.md)
- [PFProfilesGetProfilesAsync](/zh-CN/services/playfab/api-references/c/pfprofiles/functions/pfprofilesgetprofilesasync.md)