Skip to main content

XStoreQueryLicenseTokenAsync

Fournit au jeu appelant un jeton Web JSON opaque qui peut être transmis au service du jeu pour valider les droits d’utilisation et effectuer des appels B2B. Pour plus d’informations, consultez Vue d’ensemble des jetons de licence.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. productIds   _In_z_count_(productIdsCount)
Type : char**
Tableau des ID de produits pour lesquels récupérer des jetons. productIdsCount   _In_
Type : size_t
Nombre d’ID dans le tableau passé dans productIds. customDeveloperString   _In_z_
Type : char*
Valeur renvoyée telle quelle dans le jeton. Elle est généralement choisie par le service. Vous pouvez y insérer, par exemple, un userId ou une adresse courriel pour suivre le jeton de l’utilisateur dans le jeton de licence. Un jeton de licence s’utilise comme un reçu de propriété. Cette valeur ne peut pas être null ni une chaîne vide. async   _Inout_
Type : XAsyncBlock*
Un XAsyncBlock définissant le travail asynchrone en cours. Le XAsyncBlock peut être utilisé pour interroger l’état de l’appel et récupérer les résultats de l’appel. Pour plus d’informations, consultez XAsyncBlock.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

Pour récupérer le jeton Web JSON ainsi que le résultat de l’exécution de cette fonction, appelez XStoreQueryLicenseTokenResult après avoir appelé cette fonction. Pour récupérer la taille du jeton Web JSON, appelez XStoreQueryLicenseTokenResultSize après avoir appelé cette fonction. Connaître la taille du jeton vous permettra de le récupérer plus efficacement. Le jeton de licence est un jeton Web JSON encodé en Base64. La charge utile du jeton est une chaîne encodée en Base64 qui se convertit en valeurs JSON pouvant être utilisées sur le serveur à des fins de validation. L’extrait de code suivant montre un exemple de récupération d’un jeton de licence.

Configuration requise

En-tête : XStore.h (inclus dans XGameRuntime.h) Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XStore Vue d’ensemble des jetons de licence XStoreQueryLicenseTokenResult XStoreQueryLicenseTokenResultSize
Last modified on October 6, 2026