> ## 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 jeton d'entité en passant un PFServiceConfigHandle et une clé secrète de titre. En cas de réussite, elle émet un nouveau jeton d'entité et un événement PlayStream.

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 PFAuthenticationGetEntityWithSecretKeyAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const char* secretKey,  
    const PFAuthenticationGetEntityRequest* request,  
    XAsyncBlock* async  
)  
```

### Paramètres

**`serviceConfigHandle`**   PFServiceConfigHandle

PFServiceConfigHandle retourné par l'appel PFServiceConfigCreateHandle.

**`secretKey`**   char\*\
*In\_z*

Clé secrète du titre utilisée pour authentifier la requête de service.

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

Objet de requête rempli.

**`async`**   XAsyncBlock\*\
*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 [PFAuthenticationGetEntityWithSecretKeyGetResult](/fr-CA/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-CA/services/playfab/api-references/c/pfauthentication/pfauthentication_members)


## Related topics

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