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

> Met à jour le jeton d'entité PlayFab associé à cet utilisateur local, en vue de son utilisation dans les opérations authentifiées futures.

Met à jour le jeton d'entité PlayFab associé à cet utilisateur local, en vue de son utilisation dans les opérations authentifiées futures.

## Syntaxe

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

### Paramètres

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

Le nouveau jeton d'entité PlayFab à associer à l'utilisateur local.

### Valeur de retour

PartyError

`c_partyErrorSuccess` si l'appel a réussi; sinon, un code d'erreur. La forme lisible du code d'erreur peut être obtenue au moyen de [PartyManager::GetErrorMessage()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Remarques

Cette méthode prend un jeton d'entité PlayFab comme `entityToken`. Aucune validation synchrone n'est effectuée sur cette valeur. Lorsque la bibliothèque effectue des opérations nécessitant l'authentification ou l'autorisation de l'utilisateur, comme la création d'un réseau, l'authentification dans un réseau ou la transcription de la parole en texte, le service Party vérifie que le jeton est valide, n'a pas expiré, est associé au même ID d'entité que celui fourni lors de l'appel à [PartyManager::CreateLocalUser()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) ou [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md), et est autorisé à effectuer l'opération. Si ces conditions ne sont pas remplies, l'opération échoue. \
\
 Un jeton d'entité PlayFab peut être obtenu à partir du résultat d'une opération de connexion PlayFab, puis fourni en entrée à cette méthode. Le jeton doit être associé au même ID et au même type d'entité PlayFab que ceux spécifiés à l'origine à [PartyManager::CreateLocalUser()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) ou [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md).   \
\
 Le `entityToken` fourni doit avoir été obtenu à l'aide du même ID de titre que celui transmis à [PartyManager::Initialize()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md).   \
\
 La bibliothèque Party effectue une copie du jeton d'entité PlayFab fourni pour l'utiliser dans les opérations ultérieures qui nécessitent l'authentification ou l'autorisation de l'utilisateur local, comme [PartyManager::CreateNewNetwork()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md) ou [PartyNetwork::AuthenticateLocalUser()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser.md). Si le jeton fourni à cet appel a expiré ou n'est pas valide pour une autre raison, les opérations qui nécessitent un jeton valide échouent. Un nouveau jeton valide peut être fourni à la bibliothèque Party par un autre appel à cette méthode.   \
\
 Il incombe à l'appelant de surveiller l'expiration du jeton d'entité fourni à cette méthode et à [PartyManager::CreateLocalUser()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) ou [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md). Lorsque le jeton approche de son heure d'expiration ou l'a dépassée, un nouveau jeton doit être obtenu en effectuant une opération de connexion PlayFab, puis fourni à la bibliothèque Party en appelant cette méthode. Nous recommandons d'obtenir un nouveau jeton lorsque le jeton fourni précédemment a atteint la moitié de sa période de validité. Sur les plateformes susceptibles de passer en mode basse consommation ou de suspendre l'exécution de l'application pendant une longue période, empêchant ainsi l'actualisation du jeton avant son expiration, l'expiration du jeton doit être vérifiée dès la reprise de l'exécution.

## Configuration requise

**En-tête :** Party.h

## Voir aussi

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


## Related topics

- [Notes de version de PlayFab Party](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PartyManager::CreateLocalUser](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)
- [PartyManager::Initialize](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)
- [PartyNetwork::AuthenticateLocalUser](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser.md)