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

> Définit le jeton d'authentification utilisé lors des actions de la bibliothèque effectuées pour le compte d'une entité, en remplaçant tout jeton précédemment défini pour cette entité.

Définit le jeton à utiliser pour l'authentification lors des actions de la bibliothèque effectuées pour le compte d'une entité. Si un jeton a déjà été défini pour l'entité, celui-ci remplace le jeton précédent.

## Syntaxe

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

### Paramètres

**`handle`**   PFMultiplayerHandle

Handle de l'instance de l'API PFMultiplayer.

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

Clé d'entité PlayFab à associer à un jeton.

**`entityToken`**   char\*\
*se termine par un caractère null*

TBD

### Valeur renvoyée

Type : HRESULT

`S_OK` si la création de l'utilisateur local a réussi, ou un code d'erreur dans le cas contraire. La forme lisible du code d'erreur peut être récupérée via [PFMultiplayerGetErrorMessage()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Remarques

Cette méthode prend une clé d'entité PlayFab comme `entity` et un jeton d'entité PlayFab comme `token`. Lorsque la bibliothèque effectue, pour le compte d'une entité, des opérations nécessitant une authentification ou une autorisation, comme la création ou la mise à jour d'un lobby, elle recherche un jeton associé à l'entité à utiliser pour l'opération. Si aucun jeton n'a encore été défini pour l'entité, l'opération échoue de manière synchrone. Pendant l'opération asynchrone, le service PlayFab vérifie que le jeton est valide, qu'il n'a pas expiré, qu'il est associé à l'ID d'entité fourni et qu'il est autorisé à effectuer l'opération. Si ces conditions ne sont pas remplies, l'opération échoue. <br /><br /> Une clé d'entité et un jeton d'entité PlayFab peuvent être obtenus à partir de la sortie d'une opération de connexion PlayFab, puis fournis en entrée de cette méthode.   <br /><br /> Les `entity` et `token` fournis doivent avoir été obtenus à l'aide du même Title ID PlayFab que celui transmis à [PFMultiplayerInitialize()](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize).   <br /><br /> La bibliothèque Multiplayer effectue une copie du jeton d'entité PlayFab fourni pour l'utiliser dans les opérations ultérieures nécessitant l'authentification ou l'autorisation de l'utilisateur local, comme `PFMultiplayerCreateAndJoinLobby`. Si le jeton fourni à cet appel a expiré ou n'est pas valide, les opérations nécessitant un jeton valide échouent. Un nouveau jeton valide peut être fourni à la bibliothèque Multiplayer en appelant de nouveau cette méthode avec la même clé d'entité.   <br /><br /> Il incombe à l'appelant de surveiller l'expiration du jeton d'entité fourni à cette méthode. Lorsque le jeton approche de sa date 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 Multiplayer en appelant de nouveau cette méthode. Il est recommandé d'obtenir un nouveau jeton lorsque le jeton précédemment fourni 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 l'actualisation du jeton avant son expiration, il convient de vérifier l'expiration du jeton dès la reprise de l'exécution.   <br /><br /> Aucune validation synchrone n'est effectuée sur ces valeurs.

## Configuration requise

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

## Voir aussi

[Membres de PFMultiplayer](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerInitialize](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize)


## Related topics

- [PFMultiplayerInitialize](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)
- [Passer de MPSD à PlayFab Multiplayer et MPA](/fr/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Démarrage rapide du SDK Lobby](/fr/services/playfab/multiplayer/lobby/lobby-getting-started.md)
- [Démarrage rapide du SDK Matchmaking](/fr/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Vue d'ensemble de l'API C/C++ PFMultiplayer - PFMultiplayer.h](/fr/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)