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

> Crea un objeto de usuario local que se usa para representar a un jugador local al realizar operaciones de red y chat.

Crea un objeto de usuario local que se usa para representar a un jugador local al realizar operaciones de red y chat.

## Sintaxis

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

### Parámetros

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

El identificador de entidad de PlayFab que se va a asociar al usuario local.

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

El token de entidad de PlayFab que se va a asociar al usuario local.

**`localUser`**   [PartyLocalUser\*\*](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser)\
*salida asignada por la biblioteca*

El objeto de usuario local de salida.

### Valor devuelto

PartyError

`c_partyErrorSuccess` si la creación del usuario local se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante [GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage).

## Comentarios

Este método toma un identificador de entidad de PlayFab como `entityId` y un token de entidad de PlayFab como `titlePlayerEntityToken`. No se realiza ninguna validación sincrónica de estos valores, excepto que la longitud de `entityId` sea menor o igual que `c_maxEntityIdStringLength`. Cuando la biblioteca realiza operaciones que requieren autenticación o autorización del usuario, como crear una red, autenticarse en una red o realizar una transcripción de voz a texto, el servicio Party validará que el token es válido, que no ha expirado, que está asociado al identificador de entidad proporcionado y que está autorizado a realizar la operación. Si no se cumplen estas condiciones, la operación generará un error. <br /><br /> Se puede obtener un identificador de entidad y un token de entidad de PlayFab a partir de la salida de una operación de inicio de sesión de PlayFab y, a continuación, proporcionarlos como entrada a este método. El identificador de entidad de PlayFab debe ser de tipo `title_player_account` que, para la mayoría de los desarrolladores, representa al "jugador" de la manera más tradicional. Para crear usuarios que representen otros tipos de entidades compatibles, use [CreateLocalUserWithEntityType()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype) en su lugar.   <br /><br /> Los valores `entityId` y `titlePlayerEntityToken` proporcionados deben haberse adquirido con el mismo identificador de título que se pasó a [Initialize()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize).   <br /><br /> La biblioteca de Party realiza una copia del token de entidad de PlayFab proporcionado para su uso en operaciones posteriores que requieren autenticación o autorización del usuario local, como [CreateNewNetwork()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork) o [PartyNetwork::AuthenticateLocalUser()](/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser). Si el token proporcionado a esta llamada ha expirado o no es válido por otro motivo, las operaciones que requieren un token válido generarán un error. Se puede proporcionar un token nuevo y válido a la biblioteca de Party mediante una llamada a [PartyLocalUser::UpdateEntityToken()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken).   <br /><br /> El autor de la llamada es responsable de supervisar la expiración del token de entidad proporcionado a este método y a PartyLocalUser::UpdateEntityToken(). Cuando el token se acerque a la hora de expiración o la haya superado, se debe obtener un nuevo token realizando una operación de inicio de sesión de PlayFab y proporcionarlo a la biblioteca de Party llamando a PartyLocalUser::UpdateEntityToken(). Se recomienda adquirir un nuevo token cuando el token proporcionado anteriormente se encuentre a mitad de su período de validez. En las plataformas que pueden entrar en un estado de bajo consumo o hacer que la aplicación pause la ejecución durante mucho tiempo, lo que impide que el token se actualice antes de que expire, se debe comprobar la expiración del token una vez que se reanude la ejecución.   <br /><br /> Solo pueden existir `c_maxLocalUsersPerDeviceCount` objetos PartyLocalUser simultáneamente en un momento dado. Este método generará un error de forma sincrónica si la creación de otro usuario local supera ese límite.   <br /><br /> Si se devuelve correctamente, este método invalida la memoria de cualquier matriz devuelta anteriormente por [GetLocalUsers()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers), ya que agrega de forma sincrónica el nuevo usuario a la matriz. [StartProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) también invalida la memoria de la matriz. El objeto `localUser` devuelto será válido hasta que se haya generado un [PartyDestroyLocalUserCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partydestroylocalusercompletedstatechange) y todos los cambios de estado que hacen referencia al objeto se hayan devuelto a [FinishProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges).

## Requisitos

**Encabezado:** Party.h

## Consulte también

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


## Related topics

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