> ## 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 を更新するためのメソッドです。

## 構文

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

### パラメーター

**`serviceConfigHandle`**   PFServiceConfigHandle

PFServiceConfigCreateHandle 呼び出しから返される PFServiceConfigHandle。

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

サービス リクエストの認証に使用するタイトル シークレット キー。

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

値が設定されたリクエスト オブジェクト。

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

非同期操作用の XAsyncBlock。

### 戻り値

型: HRESULT

この API 操作の結果コード。

## 解説

この API は Win32、Linux、macOS で利用できます。この API は X-SecretKey、X-Authentication、または X-EntityToken ヘッダーを付けて呼び出す必要があります。省略可能な EntityKey を指定して、返される EntityToken を特定のエンティティに設定しようとすることもできますが、そのエンティティはキャラクターの master\_player\_account など、呼び出し元の関係先である必要があります。X-EntityToken を送信すると、そのアカウントは新しくログインしたものとしてマークされ、新しいトークンが発行されます。X-Authentication または X-EntityToken を使用する場合、ヘッダーは有効な状態でなければならず、期限切れや取り消し済みであってはなりません。非同期タスクが完了したら、[PFAuthenticationGetEntityWithSecretKeyGetResult](/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeygetresult) を呼び出して結果を取得します。

## 要件

**ヘッダー:** PFAuthentication.h

## 関連項目

[PFAuthentication のメンバー](/services/playfab/api-references/c/pfauthentication/pfauthentication_members)


## Related topics

- [PFAuthenticationGetEntityWithSecretKeyGetResult](/ja-jp/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeygetresult.md)
- [PFSegmentsServerGetAllSegmentsAsync](/ja-jp/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetallsegmentsasync.md)
- [PFTitleDataManagementServerGetTimeAsync](/ja-jp/services/playfab/api-references/c/pftitledatamanagement/functions/pftitledatamanagementservergettimeasync.md)
- [PFAccountManagementServerGetUserBansAsync](/ja-jp/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementservergetuserbansasync.md)
- [PFAccountManagementServerGetPlayerProfileAsync](/ja-jp/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementservergetplayerprofileasync.md)