Skip to main content

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. Ajoutez les valeurs du jeton X et de la signature issues de la version Results de l’API aux en-têtes Authorization et Signature de l’appel HTTPS avant d’effectuer la requête.

Syntaxe

Paramètres

user   _In_
Type : XUserHandle
Handle de l’utilisateur concerné par la requête web. options   _In_
Type : 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*
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 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.

Remarques

La fonction XUserGetTokenAndSignatureUtf16Async utilise un argument d’énumération 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. Pour récupérer la taille de mémoire tampon nécessaire pour contenir les résultats de l’appel à XUserGetTokenAndSignatureUtf16Async, appelez 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

Voir aussi

XUser XUserGetTokenAndSignatureUtf16Result XUserGetTokenAndSignatureUtf16ResultSize
Last modified on October 6, 2026