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

# PFAuthenticationGetEntityAsync

> Échange un AuthenticationTicket hérité ou une SecretKey de titre contre un jeton d'entité, ou actualise un jeton encore valide, en utilisant un PFEntityHandle pour l'authentification.

Méthode permettant d'échanger un AuthenticationTicket hérité ou une SecretKey de titre contre un jeton d'entité, ou d'actualiser un jeton d'entité encore valide.

## Syntaxe

```cpp theme={null}
HRESULT PFAuthenticationGetEntityAsync(  
    PFEntityHandle entityHandle,  
    const PFAuthenticationGetEntityRequest* request,  
    XAsyncBlock* async  
)  
```

### Paramètres

**`entityHandle`**   PFEntityHandle

PFEntityHandle à utiliser pour l'authentification.

**`request`**   [PFAuthenticationGetEntityRequest\*](/fr-CA/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationgetentityrequest)

Objet de requête rempli.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock pour l'opération asynchrone.

### Valeur de retour

Type : HRESULT

Code de résultat de cette opération d'API.

## Notes

Cette API est disponible sur Windows, Linux et macOS. Cette API doit être appelée avec les en-têtes X-SecretKey, X-Authentication ou X-EntityToken. L'en-tête doit toujours être valide et ne peut pas être expiré ni révoqué. En cas de réussite, elle émettra un nouveau jeton d'entité et l'événement PlayStream 'entity\_logged\_in'. Lorsque la tâche asynchrone est terminée, appelez [PFAuthenticationGetEntityGetResult](/fr-CA/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitygetresult) pour obtenir le résultat.

## Configuration requise

**En-tête :** PFAuthentication.h

## Voir aussi

[Membres de PFAuthentication](/fr-CA/services/playfab/api-references/c/pfauthentication/pfauthentication_members)


## Related topics

- [PFAuthenticationGetEntityGetResult](/fr-CA/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitygetresult.md)
- [Notes de publication du SDK C/C++ PlayFab Services](/fr-CA/services/playfab/release-notes/playfab-c/index.md)
- [Vue d'ensemble de l'API C Services - PFAuthentication.h](/fr-CA/services/playfab/api-references/c/pfauthentication/pfauthentication_members.md)
- [PFAuthenticationGetEntityWithSecretKeyAsync](/fr-CA/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeyasync.md)
- [PFAuthenticationValidateEntityTokenAsync](/fr-CA/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationvalidateentitytokenasync.md)