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

> Atualiza o token de entidade do PlayFab associado a este usuário local, para uso em futuras operações autenticadas.

Atualiza o token de entidade do PlayFab associado a este usuário local, para uso em futuras operações autenticadas.

## Sintaxe

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

### Parâmetros

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

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

### Valor retornado

PartyError

`c_partyErrorSuccess` se a chamada 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 [PartyManager::GetErrorMessage()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md).

## Comentários

Este método recebe um token de entidade do PlayFab como `entityToken`. Nenhuma validação síncrona é realizada nesse valor. 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 à mesma ID de entidade que foi fornecida à chamada a [PartyManager::CreateLocalUser()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) ou [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md) e tem autorização para realizar a operação. Se essas condições não forem atendidas, a operação falhará. \
\
 Um token de entidade do PlayFab pode ser obtido a partir da saída de uma operação de login do PlayFab e, em seguida, fornecido como entrada para este método. O token deve estar associado à mesma ID e ao mesmo tipo de entidade do PlayFab especificados originalmente para [PartyManager::CreateLocalUser()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) ou [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md).   \
\
 O `entityToken` fornecido deve ter sido obtido usando a mesma ID de título que foi passada para [PartyManager::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 [PartyManager::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 outra chamada a este método.   \
\
 O chamador é responsável por monitorar a expiração do token de entidade fornecido a este método e a [PartyManager::CreateLocalUser()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md) ou [PartyManager::CreateLocalUserWithEntityType()](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md). 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 este método. 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.

## Requisitos

**Cabeçalho:** Party.h

## Confira também

[PartyLocalUser](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/partylocaluser.md)\
[PartyManager::GetErrorMessage](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md)\
[PartyManager::CreateLocalUser](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)\
[PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.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)


## Related topics

- [Notas de versão do PlayFab Party](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/release-notes.md)
- [PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PartyManager::CreateLocalUser](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)
- [PartyManager::Initialize](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_initialize.md)
- [PartyNetwork::AuthenticateLocalUser](https://docs.xbox.com/pt-BR/services/playfab/multiplayer/networking/reference/classes/PartyNetwork/methods/partynetwork_authenticatelocaluser.md)