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

# PFAuthenticationGetEntityWithSecretKeyAsync

> 타이틀 SecretKey를 Entity Token으로 교환하거나, PlayFab 서버 측 통합이 API 호출에 사용하는 아직 유효한 Entity Token을 새로 고칩니다.

레거시 AuthenticationTicket 또는 타이틀 SecretKey를 Entity Token으로 교환하거나, 아직 유효한 Entity Token을 새로 고치는 메서드입니다.

## Syntax

```cpp theme={null}
HRESULT PFAuthenticationGetEntityWithSecretKeyAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const char* secretKey,  
    const PFAuthenticationGetEntityRequest* request,  
    XAsyncBlock* async  
)  
```

### Parameters

**`serviceConfigHandle`**   PFServiceConfigHandle

PFServiceConfigCreateHandle 호출에서 반환된 PFServiceConfigHandle입니다.

**`secretKey`**   char\*<br />*In\_z*

서비스 요청을 인증하는 데 사용되는 타이틀 비밀 키입니다.

**`request`**   [PFAuthenticationGetEntityRequest\*](/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationgetentityrequest)

값이 채워진 요청 객체입니다.

**`async`**   XAsyncBlock\*<br />*Inout*

비동기 작업을 위한 XAsyncBlock입니다.

### Return value

Type: HRESULT

이 API 작업의 결과 코드입니다.

## Remarks

이 API는 Win32, Linux, macOS에서 사용할 수 있습니다. 이 API는 X-SecretKey, X-Authentication 또는 X-EntityToken 헤더와 함께 호출되어야 합니다. 결과 EntityToken을 특정 엔터티로 설정하려고 시도하기 위해 선택적 EntityKey를 포함할 수 있지만, 해당 엔터티는 캐릭터의 master\_player\_account와 같이 호출자의 관계여야 합니다. X-EntityToken을 전송하는 경우, 계정은 새로 로그인된 것으로 표시되고 새 토큰이 발급됩니다. X-Authentication 또는 X-EntityToken을 사용하는 경우, 헤더가 여전히 유효해야 하며 만료되거나 취소되지 않아야 합니다. 비동기 작업이 완료되면 [PFAuthenticationGetEntityWithSecretKeyGetResult](/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeygetresult)를 호출하여 결과를 가져오세요.

## Requirements

**Header:** PFAuthentication.h

## See also

[PFAuthentication members](/services/playfab/api-references/c/pfauthentication/pfauthentication_members)