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 SeriesDocumentation conceptuelle
- Accorder aux joueurs l’accès au contenu des extensions
- Activation des tests de licences
- DRM de base et vérifications de licence
- Utilisation des jetons de licence pour valider les licences sur vos services
