> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyLocalUser::UpdateEntityToken

> このローカル ユーザーに関連付けられた PlayFab エンティティ トークンを、今後の認証済み操作で使用するために更新します。

このローカル ユーザーに関連付けられた PlayFab エンティティ トークンを、今後の認証済み操作で使用するために更新します。

## 構文

```cpp theme={null}
PartyError UpdateEntityToken(  
    PartyString entityToken  
)  
```

### パラメーター

**`entityToken`**   [PartyString](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/typedefs.md)

ローカル ユーザーに関連付ける新しい PlayFab エンティティ トークン。

### 戻り値

PartyError

呼び出しが成功した場合は `c_partyErrorSuccess`、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、[PartyManager::GetErrorMessage()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) から取得できます。

## 解説

このメソッドは `entityToken` として PlayFab エンティティ トークンを受け取ります。この値に対して同期的な検証は行われません。ライブラリが、ネットワークの作成、ネットワークへの認証、音声テキスト変換の実行など、ユーザー認証または承認が必要な操作を行うと、Party サービスは、トークンが有効であり、有効期限が切れておらず、[PartyManager::CreateLocalUser()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) または [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md) 呼び出しに提供されたエンティティ ID と同じものに関連付けられており、その操作の実行を承認されていることを検証します。これらの条件が満たされていない場合、操作は失敗します。\
\
 PlayFab エンティティ トークンは PlayFab ログイン操作の出力から取得でき、このメソッドへの入力として提供できます。トークンは、[PartyManager::CreateLocalUser()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) または [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md) で最初に指定されたものと同じ PlayFab エンティティ ID とタイプに関連付けられている必要があります。   \
\
 提供される `entityToken` は、[PartyManager::Initialize()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md) に渡されたのと同じタイトル ID を使用して取得されている必要があります。   \
\
 Party ライブラリは、[PartyManager::CreateNewNetwork()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md) や [PartyNetwork::AuthenticateLocalUser()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser.md) のように、ローカル ユーザーの認証や承認が必要な後続の操作で使用するために、提供された PlayFab エンティティ トークンのコピーを作成します。この呼び出しに提供されたトークンが有効期限切れであるか、それ以外の場合に無効な場合、有効なトークンが必要な操作は失敗します。このメソッドを再度呼び出すことで、新しい有効なトークンを Party ライブラリに提供できます。   \
\
 このメソッドと [PartyManager::CreateLocalUser()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) または [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md) に提供されるエンティティ トークンの有効期限を監視するのは呼び出し元の責任です。トークンが有効期限に近づいているか、有効期限を過ぎた場合、PlayFab ログイン操作を実行して新しいトークンを取得し、このメソッドを呼び出して Party ライブラリに提供する必要があります。以前に提供したトークンが有効期間の半分に達したときに、新しいトークンを取得することをお勧めします。低電力状態に入る可能性があるプラットフォームや、アプリケーションが長時間実行を一時停止する可能性のあるプラットフォームでは、トークンの更新が期限切れになる前にできなくなる可能性があるため、実行が再開されたときにトークンの有効期限を確認する必要があります。

## 要件

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

## 関連項目

[PartyLocalUser](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)\
[PartyManager::GetErrorMessage](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md)\
[PartyManager::CreateLocalUser](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)\
[PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)\
[PartyManager::CreateNewNetwork](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md)\
[PartyNetwork::AuthenticateLocalUser](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser.md)


## Related topics

- [PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PartyManager::CreateLocalUser](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)
- [PlayFab Party リリース ノート](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::Initialize](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)
- [PartyNetwork::AuthenticateLocalUser](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser.md)