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

# PartyLocalUser::UpdateEntityToken

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

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

## 構文

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

### パラメーター

**`entityToken`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

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

### 戻り値

PartyError

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

## 解説

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

## 要件

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

## 関連項目

[PartyLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser)\
[PartyManager::GetErrorMessage](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage)\
[PartyManager::CreateLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser)\
[PartyManager::CreateLocalUserWithEntityType](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype)\
[PartyManager::CreateNewNetwork](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)\
[PartyNetwork::AuthenticateLocalUser](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser)


## Related topics

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