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

# PFAuthenticationGetEntityRequest

> PFAuthenticationGetEntityRequest 資料模型。呼叫此 API 時必須使用 X-SecretKey、X-Authentication 或 X-EntityToken 標頭。標頭必須仍然有效，且不得已過期或已撤銷。如果成功，將會發出新的實體權杖，並發出 "entity_logged_in" PlayStream 事件。

PFAuthenticationGetEntityRequest 資料模型。呼叫此 API 時必須使用 X-SecretKey、X-Authentication 或 X-EntityToken 標頭。標頭必須仍然有效，且不得已過期或已撤銷。如果成功，將會發出新的實體權杖，並發出 "entity\_logged\_in" PlayStream 事件。

## 語法

```cpp theme={null}
typedef struct PFAuthenticationGetEntityRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
} PFAuthenticationGetEntityRequest;  
```

### 成員

**`customTags`**   PFStringDictionaryEntry const\*<br />*may be nullptr*

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

**`customTagsCount`**   uint32\_t

customTags 的計數

## 需求

**標頭：** PFAuthenticationTypes.h

## 另請參閱

[PFAuthenticationTypes 成員](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members)


## Related topics

- [PFAuthenticationGetEntityAsync](/zh-TW/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentityasync.md)
- [PFAuthenticationGetEntityWithSecretKeyAsync](/zh-TW/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeyasync.md)
- [PlayFab Services C/C++ SDK 版本資訊](/zh-TW/services/playfab/release-notes/playfab-c/index.md)
- [PFAuthenticationValidateEntityTokenRequest](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationvalidateentitytokenrequest.md)
- [PFAuthenticationGetEntityGetResult](/zh-TW/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitygetresult.md)