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

# PFAuthenticationGetEntityWithSecretKeyAsync

> Obtient un Entity Token en transmettant un PFServiceConfigHandle et une Secret Key de titre. En cas de réussite, un nouveau jeton d'entité est émis et un événement PlayStream est généré.

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

## Syntaxe

```cpp theme={null}
HRESULT PFAuthenticationGetEntityWithSecretKeyAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const char* secretKey,  
    const PFAuthenticationGetEntityRequest* request,  
    XAsyncBlock* async  
)  
```

### Paramètres

**`serviceConfigHandle`**   PFServiceConfigHandle

PFServiceConfigHandle renvoyé par l'appel PFServiceConfigCreateHandle.

**`secretKey`**   char\*<br />*In\_z*

Secret Key de titre utilisée pour authentifier la requête de service.

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

Objet de requête renseigné.

**`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 être encore valide et ne peut pas être expiré ni révoqué. En cas de réussite, elle émet un nouveau jeton d'entité et génère l'événement PlayStream 'entity\_logged\_in'. Une fois la tâche asynchrone terminée, appelez [PFAuthenticationGetEntityWithSecretKeyGetResult](/fr/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeygetresult) pour obtenir le résultat.

## Configuration requise

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

## Voir aussi

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


## Related topics

- [PFAuthenticationGetEntityWithSecretKeyGetResult](/fr/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationgetentitywithsecretkeygetresult.md)
- [PFSegmentsServerGetAllSegmentsAsync](/fr/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetallsegmentsasync.md)
- [PFTitleDataManagementServerGetTimeAsync](/fr/services/playfab/api-references/c/pftitledatamanagement/functions/pftitledatamanagementservergettimeasync.md)
- [PFSegmentsServerGetPlayerSegmentsAsync](/fr/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayersegmentsasync.md)
- [PFSegmentsServerGetPlayerTagsAsync](/fr/services/playfab/api-references/c/pfsegments/functions/pfsegmentsservergetplayertagsasync.md)