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

> Establece el token de autenticación que se usa al realizar acciones de la biblioteca en nombre de una entidad, reemplazando cualquier token establecido previamente para esa entidad.

Establece el token que debe usarse para la autenticación al realizar acciones de la biblioteca en nombre de una entidad. Si ya se ha establecido previamente un token para la entidad, esto reemplaza su token anterior.

## Sintaxis

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

### Parámetros

**`handle`**   PFMultiplayerHandle

El identificador de la instancia de la API PFMultiplayer.

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

La clave de entidad de PlayFab que se va a asociar a un token.

**`entityToken`**   char\*\
*termina en null*

TBD

### Valor devuelto

Tipo: HRESULT

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

## Comentarios

Este método toma una clave de entidad de PlayFab como `entity` y un token de entidad de PlayFab como `token`. Cuando la biblioteca realiza operaciones en nombre de una entidad que requieren autenticación o autorización, como crear o actualizar un lobby, la biblioteca busca un token asociado a la entidad para usarlo en la operación. Si no se ha establecido previamente ningún token para la entidad, la operación producirá un error de forma sincrónica. Durante la operación asincrónica, el servicio de PlayFab valida que el token sea válido, no haya expirado, esté asociado al identificador de entidad proporcionado y esté autorizado para realizar la operación. Si no se cumplen estas condiciones, la operación producirá un error. <br /><br /> Se pueden obtener una clave 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, después, proporcionarse como entrada a este método.   <br /><br /> Los valores `entity` y `token` proporcionados deben haberse adquirido con el mismo identificador de título de PlayFab que se pasó a [PFMultiplayerInitialize()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize).   <br /><br /> La biblioteca Multiplayer realiza una copia del token de entidad de PlayFab proporcionado para usarlo en operaciones posteriores que requieran autenticación o autorización del usuario local, como `PFMultiplayerCreateAndJoinLobby`. Si el token proporcionado a esta llamada ha expirado o no es válido por otro motivo, las operaciones que requieran un token válido producirán un error. Se puede proporcionar un token nuevo y válido a la biblioteca Multiplayer llamando de nuevo a este método con la misma clave de entidad.   <br /><br /> El autor de la llamada es responsable de supervisar la expiración del token de entidad proporcionado a este método. Cuando el token se acerque al momento de expiración o lo haya superado, se debe obtener un nuevo token mediante una operación de inicio de sesión de PlayFab y proporcionarlo a la biblioteca Multiplayer llamando de nuevo a este método. Se recomienda adquirir un nuevo token cuando el token proporcionado anteriormente esté a la mitad de su período de validez. En plataformas que puedan entrar en un estado de bajo consumo o que de otro modo hagan que la aplicación pause su 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 /> No se realiza ninguna validación sincrónica de estos valores.

## Requisitos

**Encabezado:** PFMultiplayer.h

## Consulte también

[Miembros de PFMultiplayer](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members)\
[PFMultiplayerInitialize](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize)


## Related topics

- [PFMultiplayerInitialize](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)
- [Inicio rápido del SDK de Lobby](/es/services/playfab/multiplayer/lobby/lobby-getting-started.md)
- [Inicio rápido del SDK de Matchmaking](/es/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [Migración de MPSD a PlayFab Multiplayer y MPA](/es/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Información general de la API de C/C++ de PFMultiplayer - PFMultiplayer.h](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfmultiplayer_members.md)