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

> Define o token de autenticação usado ao executar ações da biblioteca em nome de uma entidade, substituindo qualquer token definido anteriormente para essa entidade.

Define o token que deve ser usado para autenticação ao executar ações da biblioteca em nome de uma entidade. Se um token tiver sido definido anteriormente para a entidade, este substituirá o token anterior.

## Sintaxe

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

### Parâmetros

**`handle`**   PFMultiplayerHandle

O identificador da instância da API PFMultiplayer.

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

A chave de entidade do PlayFab a ser associada a um token.

**`entityToken`**   char\*\
*terminada em nulo*

A definir

### Valor retornado

Tipo: HRESULT

`S_OK` 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 [PFMultiplayerGetErrorMessage()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentários

Este método recebe uma chave de entidade do PlayFab como `entity` e um token de entidade do PlayFab como `token`. Quando a biblioteca executa operações em nome de uma entidade que exigem autenticação ou autorização, como criar ou atualizar um lobby, a biblioteca procura um token associado à entidade para usar na operação. Se nenhum token tiver sido definido anteriormente para a entidade, a operação falhará de forma síncrona. Durante a operação assíncrona, o serviço PlayFab validará se o token é válido, não expirou, está associado à ID de entidade fornecida e está autorizado a executar a operação. Se essas condições não forem atendidas, a operação falhará. \
\
 Uma chave de entidade e um token de entidade do PlayFab podem ser obtidos da saída de uma operação de login do PlayFab e, em seguida, fornecidos como entrada para este método.   \
\
 A `entity` e o `token` fornecidos precisam ter sido obtidos usando a mesma Title ID do PlayFab que foi passada para [PFMultiplayerInitialize()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize).   \
\
 A biblioteca Multiplayer 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 `PFMultiplayerCreateAndJoinLobby`. Se o token fornecido a esta chamada estiver expirado ou for inválido por outro motivo, as operações que exigem um token válido falharão. Um token novo e válido pode ser fornecido à biblioteca Multiplayer chamando este método novamente com a mesma chave de entidade.   \
\
 O chamador é responsável por monitorar a expiração do token de entidade fornecido a este método. Quando o token estiver próximo do horário de expiração ou já tiver passado dele, um novo token deverá ser obtido executando uma operação de login do PlayFab e fornecido à biblioteca Multiplayer chamando este método novamente. É recomendável obter um novo token quando o token fornecido anteriormente estiver na metade do período de validade. Em plataformas que podem entrar em um estado de baixo consumo de energia ou, de outra forma, fazer com que o aplicativo pause a execução por muito tempo, impedindo que o token seja atualizado antes de expirar, a expiração do token deve ser verificada assim que a execução for retomada.   \
\
 Nenhuma validação síncrona é executada nesses valores.

## Requisitos

**Cabeçalho:** PFMultiplayer.h

## Confira também

[Membros do PFMultiplayer](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerInitialize](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize)


## Related topics

- [PFMultiplayerInitialize](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)
- [Início rápido do SDK de Matchmaking](/pt-BR/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Início rápido do SDK do Lobby](/pt-BR/services/playfab/multiplayer/lobby/lobby-getting-started.md)
- [Migrando do MPSD para o PlayFab Multiplayer e o MPA](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Visão geral da API C/C++ do PFMultiplayer – PFMultiplayer.h](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)