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

# XUserGetTokenAndSignatureUtf16Async

> XUserGetTokenAndSignatureUtf16Async

# XUserGetTokenAndSignatureUtf16Async

API qui récupère de façon asynchrone le jeton X et la signature nécessaires pour autoriser un appel HTTPS vers l'URL cible. Elle retourne un jeton X et une signature si une partie de confiance (Relying Party) est liée à l'URL cible dans la [page d'authentification unique du titre dans Partner Center](/fr/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/single-sign-on/live-single-sign-on). Ajoutez les valeurs du jeton X et de la signature issues de la [version Results de l'API](/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16result) aux en-têtes Authorization et Signature de l'appel HTTPS avant d'effectuer la requête.

## Syntaxe

```cpp theme={null}
HRESULT XUserGetTokenAndSignatureUtf16Async(  
         XUserHandle user,  
         XUserGetTokenAndSignatureOptions options,  
         const wchar_t* method,  
         const wchar_t* url,  
         size_t headerCount,  
         const XUserGetTokenAndSignatureUtf16HttpHeader* headers,  
         size_t bodySize,  
         const void* bodyBuffer,  
         XAsyncBlock* async  
)  
```

### Paramètres

*user*   \_In\_\
Type : XUserHandle

Handle de l'utilisateur concerné par la requête web.

*options*   \_In\_\
Type : [XUserGetTokenAndSignatureOptions](/fr/reference/system/xuser/enums/xusergettokenandsignatureoptions)

Options de récupération du jeton et de la signature de l'utilisateur.

*method*   \_In\_z\_\
Type : wchar\_t\*

Type de méthode de la requête web, en Unicode.

*url*   \_In\_z\_\
Type : wchar\_t\*

URL cible de votre requête HTTPS. Utilisez la chaîne d'URL complète pour la requête HTTPS. N'abrégez pas l'URL.

*headerCount*   \_In\_\
Type : size\_t

Nombre d'en-têtes dans le paramètre *headers*.

*headers*   \_In\_reads\_opt\_(headerCount)\
Type : [XUserGetTokenAndSignatureUtf16HttpHeader\*](/fr/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader)

En-têtes de la requête web.

*bodySize*   \_In\_\
Type : size\_t

Taille de la mémoire tampon dans le paramètre *bodyBuffer*.

*bodyBuffer*   \_In\_reads\_bytes\_opt\_(bodySize)\
Type : void\*

Mémoire tampon qui contient le corps de la requête web.

*async*   \_Inout\_\
Type : XAsyncBlock\*

[XAsyncBlock](/fr/reference/system/xasync/structs/xasyncblock) permettant d'interroger l'état de l'appel et de récupérer ses résultats.

### Valeur de retour

Type : HRESULT

Retourne S\_OK en cas de réussite ; sinon, retourne un code d'erreur.
Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr/reference/errorcodes).

## Remarques

La fonction XUserGetTokenAndSignatureUtf16Async utilise un argument d'énumération [XUserGetTokenAndSignatureOptions](/fr/reference/system/xuser/enums/xusergettokenandsignatureoptions) pour récupérer de façon asynchrone des jetons X et des signatures Unicode pour des requêtes web.

Pour récupérer le résultat de l'appel à XUserGetTokenAndSignatureUtf16Async, appelez [XUserGetTokenAndSignatureUtf16Result](/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16result).

Pour récupérer la taille de mémoire tampon nécessaire pour contenir les résultats de l'appel à XUserGetTokenAndSignatureUtf16Async, appelez [XUserGetTokenAndSignatureUtf16ResultSize](/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize).

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX Series

## Documentation conceptuelle

* [Vue d'ensemble de WinHTTP](/fr/build/console-features/networking/web-requests/intro-winhttp)
* [Implémenter la connexion des joueurs](/fr/services/xbox-services/playfab-integration)

## Voir aussi

[XUser](/fr/reference/system/xuser/xuser_members)

[XUserGetTokenAndSignatureUtf16Result](/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16result)

[XUserGetTokenAndSignatureUtf16ResultSize](/fr/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize)


## Related topics

- [XUserGetTokenAndSignatureUtf16Async](/reference/system/xuser/functions/xusergettokenandsignatureutf16async.md)
- [XUserGetTokenAndSignatureUtf16Result](/reference/system/xuser/functions/xusergettokenandsignatureutf16result.md)
- [XUserGetTokenAndSignatureUtf16ResultSize](/reference/system/xuser/functions/xusergettokenandsignatureutf16resultsize.md)
- [XUserGetTokenAndSignatureUtf16Data](/reference/system/xuser/structs/xusergettokenandsignatureutf16data.md)
- [XUserGetTokenAndSignatureUtf16HttpHeader](/reference/system/xuser/structs/xusergettokenandsignatureutf16httpheader.md)