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

# PFProfilesGetEntityProfileRequest

> PFProfilesGetEntityProfileRequest 資料模型。指定實體類型和實體識別碼，即可從實體存放區擷取設定檔。如果擷取的設定檔屬於呼叫者，則讀取作業具有一致性；否則為不一致的讀取。不一致的讀取表示我們不保證在讀取設定檔之前，所有已認可的寫入都已完成，因此可能讀取到過時的資料。如果一致性很重要，可以使用結果上的版本號碼來比較任何讀取者所擁有的設定檔版本。

PFProfilesGetEntityProfileRequest 資料模型。指定實體類型和實體識別碼，即可從實體存放區擷取設定檔。如果擷取的設定檔屬於呼叫者，則讀取作業具有一致性；否則為不一致的讀取。不一致的讀取表示我們不保證在讀取設定檔之前，所有已認可的寫入都已完成，因此可能讀取到過時的資料。如果一致性很重要，可以使用結果上的版本號碼來比較任何讀取者所擁有的設定檔版本。

## 語法

```cpp theme={null}
typedef struct PFProfilesGetEntityProfileRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    bool const* dataAsObject;  
    PFEntityKey const* entity;  
    bool includeStatistics;  
} PFProfilesGetEntityProfileRequest;  
```

### 成員

**`customTags`**   [PFStringDictionaryEntry](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

（選擇性）與要求相關聯的選擇性自訂標籤（例如組建編號、外部追蹤識別碼等）。

**`customTagsCount`**   uint32\_t

customTags 的計數

**`dataAsObject`**   bool const\*<br />*may be nullptr*

（選擇性）決定物件要以已逸出的 JSON 字串或未逸出的 JSON 物件傳回。預設為 JSON 字串。

**`entity`**   [PFEntityKey](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*<br />*may be nullptr*

（選擇性）要執行此動作的選擇性實體。預設為目前已登入的實體。

**`includeStatistics`**   bool

決定是否在實體設定檔中傳回實體統計資料。預設為 false。

## 需求

**標頭：** PFProfilesTypes.h

## 另請參閱

[PFProfilesTypes 成員](/zh-TW/services/playfab/api-references/c/pfprofilestypes/pfprofilestypes_members)


## Related topics

- [PFProfilesGetProfileAsync](/zh-TW/services/playfab/api-references/c/pfprofiles/functions/pfprofilesgetprofileasync.md)
- [服務 C API 概觀 - PFProfilesTypes.h](/zh-TW/services/playfab/api-references/c/pfprofilestypes/pfprofilestypes_members.md)
- [PFProfilesGetEntityProfilesRequest](/zh-TW/services/playfab/api-references/c/pfprofilestypes/structs/pfprofilesgetentityprofilesrequest.md)
- [PFProfilesSetEntityProfilePolicyRequest](/zh-TW/services/playfab/api-references/c/pfprofilestypes/structs/pfprofilessetentityprofilepolicyrequest.md)
- [PFProfilesGetEntityProfileResponse](/zh-TW/services/playfab/api-references/c/pfprofilestypes/structs/pfprofilesgetentityprofileresponse.md)