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

# PartyManager::CreateLocalUser

> Cria um objeto de usuário local que é usado para representar um jogador local ao realizar operações de rede e de chat.

Cria um objeto de usuário local que é usado para representar um jogador local ao realizar operações de rede e de chat.

## Sintaxe

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

### Parâmetros

**`entityId`**   [PartyString](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/typedefs.md)

A ID de entidade do PlayFab a ser associada ao usuário local.

**`titlePlayerEntityToken`**   [PartyString](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/typedefs.md)

O token de entidade do PlayFab a ser associado ao usuário local.

**`localUser`**   [PartyLocalUser\*\*](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)\
*saída alocada pela biblioteca*

O objeto de usuário local de saída.

### Valor retornado

PartyError

`c_partyErrorSuccess` se a criação do usuário local tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de [GetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Comentários

Este método recebe uma ID de entidade do PlayFab como `entityId` e um token de entidade do PlayFab como `titlePlayerEntityToken`. Nenhuma validação síncrona é realizada nesses valores, exceto a verificação de que o comprimento de `entityId` é menor ou igual a `c_maxEntityIdStringLength`. Quando a biblioteca realiza operações que exigem autenticação ou autorização do usuário, como criar uma rede, autenticar-se em uma rede ou realizar a transcrição de fala em texto, o serviço do Party validará se o token é válido, não está expirado, está associado à ID de entidade fornecida e tem autorização para realizar a operação. Se essas condições não forem atendidas, a operação falhará. \
\
 Uma ID de entidade e um token de entidade do PlayFab podem ser obtidos a partir da saída de uma operação de login do PlayFab e, em seguida, fornecidos como entrada para este método. A ID de entidade do PlayFab deve ser do tipo `title_player_account`, que, para a maioria dos desenvolvedores, representa o "jogador" da forma mais tradicional. Para criar usuários que representem outros tipos de entidade com suporte, use [CreateLocalUserWithEntityType()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md).   \
\
 O `entityId` e o `titlePlayerEntityToken` fornecidos devem ter sido obtidos usando a mesma ID de título que foi passada para [Initialize()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md).   \
\
 A biblioteca do Party faz uma cópia do token de entidade do PlayFab fornecido para uso em operações subsequentes que exigem autenticação ou autorização do usuário local, como [CreateNewNetwork()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createnewnetwork.md) ou [PartyNetwork::AuthenticateLocalUser()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser.md). Se o token fornecido a esta chamada estiver expirado ou for inválido de outra forma, as operações que exigem um token válido falharão. Um token novo e válido pode ser fornecido à biblioteca do Party por meio de uma chamada a [PartyLocalUser::UpdateEntityToken()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken.md).   \
\
 O chamador é responsável por monitorar a expiração do token de entidade fornecido a este método e a PartyLocalUser::UpdateEntityToken(). Quando o token estiver próximo do horário de expiração ou já o tiver ultrapassado, um novo token deverá ser obtido realizando uma operação de login do PlayFab e fornecido à biblioteca do Party chamando PartyLocalUser::UpdateEntityToken(). Recomendamos obter um novo token quando o token fornecido anteriormente atingir a metade do seu período de validade. Em plataformas que podem entrar em um estado de baixo consumo de energia ou que, de outra forma, possam fazer com que o aplicativo pause a execução por um longo período, impedindo que o token seja atualizado antes de expirar, a expiração do token deve ser verificada assim que a execução for retomada.   \
\
 Somente `c_maxLocalUsersPerDeviceCount` objetos PartyLocalUser podem existir simultaneamente a qualquer momento. Este método falhará de forma síncrona se a criação de outro usuário local exceder esse limite.   \
\
 Em caso de retorno bem-sucedido, este método invalida a memória de qualquer matriz retornada anteriormente por [GetLocalUsers()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers.md), pois adiciona de forma síncrona o novo usuário à matriz. [StartProcessingStateChanges()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) também invalida a memória da matriz. O objeto `localUser` retornado será válido até que um [PartyDestroyLocalUserCompletedStateChange](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/structs/partydestroylocalusercompletedstatechange.md) tenha sido gerado e todas as alterações de estado que fazem referência ao objeto tenham sido devolvidas a [FinishProcessingStateChanges()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_finishprocessingstatechanges.md).

## Requisitos

**Cabeçalho:** Party.h

## Confira também

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


## Related topics

- [PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PartyManager::GetLocalUsers](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getlocalusers.md)
- [PartyLocalUser](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)
- [PartyManager::Initialize](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)
- [PartyLocalUser::UpdateEntityToken](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken.md)