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

# PartyManager::CreateLocalUser

> Crée un objet utilisateur local utilisé pour représenter un joueur local lors des opérations de mise en réseau et de chat.

Crée un objet utilisateur local utilisé pour représenter un joueur local lors des opérations de mise en réseau et de chat.

## Syntaxe

```cpp theme={null}
PartyError CreateLocalUser(  
    PartyString entityId,  
    PartyString titlePlayerEntityToken,  
    PartyLocalUser** localUser  
)  
```

### Paramètres

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

L'ID d'entité PlayFab à associer à l'utilisateur local.

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

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

**`localUser`**   [PartyLocalUser\*\*](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser)\
*library-allocated output*

L'objet utilisateur local de sortie.

### Valeur renvoyée

PartyError

`c_partyErrorSuccess` si la création de l'utilisateur local a réussi ; sinon, un code d'erreur. La forme lisible du code d'erreur peut être obtenue via [GetErrorMessage()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Remarques

Cette méthode prend un ID d'entité PlayFab comme `entityId` et un jeton d'entité PlayFab comme `titlePlayerEntityToken`. Aucune validation synchrone n'est effectuée sur ces valeurs, si ce n'est que la longueur de `entityId` doit être inférieure ou égale à `c_maxEntityIdStringLength`. 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é à l'ID d'entité fourni et est autorisé à effectuer l'opération. Si ces conditions ne sont pas remplies, l'opération échoue. <br /><br /> Un ID d'entité et un jeton d'entité PlayFab peuvent être obtenus à partir du résultat d'une opération de connexion PlayFab, puis fournis en entrée à cette méthode. L'ID d'entité PlayFab doit être de type `title_player_account`, qui, pour la plupart des développeurs, représente le « joueur » au sens le plus traditionnel. Pour créer des utilisateurs représentant d'autres types d'entités pris en charge, utilisez plutôt [CreateLocalUserWithEntityType()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype).   <br /><br /> Les valeurs `entityId` et `titlePlayerEntityToken` fournies doivent avoir été obtenues à l'aide du même ID de titre que celui transmis à [Initialize()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize).   <br /><br /> 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 [CreateNewNetwork()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork) ou [PartyNetwork::AuthenticateLocalUser()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser). 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 via un appel à [PartyLocalUser::UpdateEntityToken()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken).   <br /><br /> Il incombe à l'appelant de surveiller l'expiration du jeton d'entité fourni à cette méthode et à PartyLocalUser::UpdateEntityToken(). 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 PartyLocalUser::UpdateEntityToken(). 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.   <br /><br /> Seuls `c_maxLocalUsersPerDeviceCount` objets PartyLocalUser peuvent exister simultanément à un moment donné. Cette méthode échoue de manière synchrone si la création d'un autre utilisateur local dépasse cette limite.   <br /><br /> En cas de retour réussi, cette méthode invalide la mémoire de tout tableau précédemment renvoyé par [GetLocalUsers()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers), car elle ajoute de manière synchrone le nouvel utilisateur au tableau. [StartProcessingStateChanges()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) invalide également la mémoire du tableau. L'objet `localUser` renvoyé reste valide jusqu'à ce qu'un [PartyDestroyLocalUserCompletedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partydestroylocalusercompletedstatechange) ait été généré et que tous les changements d'état faisant référence à l'objet aient été renvoyés à [FinishProcessingStateChanges()](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges).

## Configuration requise

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

## Voir aussi

[PartyManager](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager)\
[PartyDestroyLocalUserCompletedStateChange](/fr/services/playfab/multiplayer/networking/reference/structs/partydestroylocalusercompletedstatechange)\
[PartyManager::Initialize](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize)\
[PartyManager::GetLocalUsers](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers)\
[PartyManager::CreateLocalUserWithEntityType](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype)\
[PartyManager::DestroyLocalUser](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_destroylocaluser)\
[PartyManager::CreateNewNetwork](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork)\
[PartyNetwork::AuthenticateLocalUser](/fr/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser)\
[PartyNetwork::RemoveLocalUser](/fr/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_removelocaluser)\
[PartyNetwork::CreateInvitation](/fr/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createinvitation)\
[PartyNetwork::RevokeInvitation](/fr/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_revokeinvitation)\
[PartyNetwork::CreateEndpoint](/fr/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_createendpoint)\
[PartyLocalUser::UpdateEntityToken](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken)\
[PartyLocalDevice::CreateChatControl](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol)


## Related topics

- [PartyManager::CreateLocalUserWithEntityType](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PartyManager::GetLocalUsers](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers.md)
- [PartyLocalUser](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)
- [PartyManager::Initialize](/fr/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)
- [PartyLocalUser::UpdateEntityToken](/fr/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken.md)