> ## 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](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentityasync.md)
- [PFAuthenticationGetEntityWithSecretKeyAsync](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeyasync.md)
- [Services C API 개요 - PFAuthenticationTypes.h](/ko/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationValidateEntityTokenRequest](/ko/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationvalidateentitytokenrequest.md)
- [PFAuthenticationGetEntityGetResult](/ko/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitygetresult.md)