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

# PFMultiplayerSetEntityToken

> エンティティに代わってライブラリ操作を実行する際に使用する認証トークンを設定します。そのエンティティに対して以前に設定されたトークンがあれば置き換えます。

エンティティに代わってライブラリ操作を実行する際の認証に使用するトークンを設定します。そのエンティティに対して以前にトークンが設定されている場合、以前のトークンを置き換えます。

## 構文

```cpp theme={null}
HRESULT PFMultiplayerSetEntityToken(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* entity,  
    const char* entityToken  
)  
```

### パラメーター

**`handle`**   PFMultiplayerHandle

PFMultiplayer API インスタンスのハンドル。

**`entity`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

トークンと関連付ける PlayFab エンティティ キー。

**`entityToken`**   char\*\
*is null-terminated*

TBD

### 戻り値

型: HRESULT

ローカル ユーザーの作成に成功した場合は `S_OK`、それ以外の場合はエラー コード。エラー コードの人間が読める形式は [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) を通じて取得できます。

## 注釈

このメソッドは PlayFab エンティティ キーを `entity` として、PlayFab エンティティ トークンを `token` として受け取ります。ライブラリが、ロビーの作成や更新など、認証や認可が必要なエンティティに代わる操作を実行する際、その操作に使用するトークンをエンティティに関連付けられているものから検索します。エンティティに対して以前にトークンが設定されていない場合、その操作は同期的に失敗します。非同期操作の実行中に、PlayFab サービスはトークンが有効であること、有効期限切れでないこと、指定されたエンティティ ID に関連付けられていること、およびその操作を実行する権限があることを検証します。これらの条件が満たされない場合、操作は失敗します。<br /><br /> PlayFab エンティティ キーとエンティティ トークンは、PlayFab のログイン操作の出力から取得し、このメソッドの入力として提供できます。   <br /><br /> 指定する `entity` と `token` は、[PFMultiplayerInitialize()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize) に渡したものと同じ PlayFab タイトル ID を使用して取得されている必要があります。   <br /><br /> Multiplayer ライブラリは、提供された PlayFab エンティティ トークンのコピーを保持し、`PFMultiplayerCreateAndJoinLobby` のようにローカル ユーザーの認証や認可を必要とするその後の操作に使用します。この呼び出しで提供されたトークンが有効期限切れ、またはその他の理由で無効な場合、有効なトークンが必要な操作は失敗します。同じエンティティ キーを使ってこのメソッドを再度呼び出すことで、新しい有効なトークンを Multiplayer ライブラリに提供できます。   <br /><br /> このメソッドに提供したエンティティ トークンの有効期限を監視するのは呼び出し元の責任です。トークンが有効期限に近づいた、または過ぎた場合は、PlayFab のログイン操作を実行して新しいトークンを取得し、このメソッドを再度呼び出して Multiplayer ライブラリに提供する必要があります。以前に提供したトークンが有効期間の半分を経過した時点で新しいトークンを取得することが推奨されます。低電力状態に入る可能性があるプラットフォーム、またはその他の理由でアプリケーションの実行が長時間停止し、トークンが失効前に更新できない場合には、実行が再開された時点でトークンの有効期限をチェックする必要があります。   <br /><br /> これらの値に対して同期的な検証は行われません。

## 要件

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

## 関連項目

[PFMultiplayer メンバー](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerInitialize](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize)


## Related topics

- [PFMultiplayerInitialize](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)
- [MPSD から PlayFab Multiplayer と MPA への移行](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Lobby SDK クイックスタート](/ja-jp/services/playfab/multiplayer/lobby/lobby-getting-started.md)
- [Matchmaking SDK quickstart](/ja-jp/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [ゲーム サーバーとロビー](/ja-jp/services/playfab/multiplayer/lobby/lobby-server-overview.md)