> ## 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 标头调用。可以包含可选的 EntityKey。

PFAuthenticationGetEntityRequest 数据模型。此 API 必须使用 X-SecretKey、X-Authentication 或 X-EntityToken 标头调用。可以包含可选的 EntityKey，以尝试将所生成的 EntityToken 设置为特定实体，但该实体必须与调用方存在关联，例如角色的 master\_player\_account。如果发送 X-EntityToken，帐户将被标记为刚刚登录，并将颁发新令牌。如果使用 X-Authentication 或 X-EntityToken，该标头必须仍然有效，不能过期或被吊销。

## 语法

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

### 成员

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

（可选）与请求关联的可选自定义标记（例如生成号、外部跟踪标识符等）。

**`customTagsCount`**   uint32\_t

customTags 的数量

**`entity`**   PFEntityKey const\*<br />*may be nullptr*

（可选）要对其执行此操作的可选实体。默认为当前登录的实体。

## 要求

**头文件：** PFAuthenticationTypes.h

## 另请参阅

[PFAuthenticationTypes 成员](/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members)


## Related topics

- [PFAuthenticationGetEntityAsync](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentityasync.md)
- [PFAuthenticationGetEntityWithSecretKeyAsync](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeyasync.md)
- [服务 C API 概览 - PFAuthenticationTypes.h](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationValidateEntityTokenRequest](/zh-CN/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationvalidateentitytokenrequest.md)
- [PFAuthenticationGetEntityGetResult](/zh-CN/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitygetresult.md)