Skip to main content

XStoreQueryAddOnLicensesAsync

Énumère les licences de tous les modules complémentaires durables associés à une licence de jeu numérique. Cela s’applique uniquement aux types Durable sans package et ne peut être utilisé qu’avec une licence numérique, et non avec des licences de disque. L’exécution de cette fonction avec une licence de disque produit des résultats vides, même s’il existe des durables individuels que l’utilisateur possède ou pour lesquels il peut obtenir une licence. Pour les scénarios avec disque, utilisez plutôt XStoreAcquireLicenseForDurablesAsync.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte de Store de l’utilisateur, renvoyé par XStoreCreateContext. async   _Inout_
Type : XAsyncBlock*
XAsyncBlock définissant le travail asynchrone en cours. Le XAsyncBlock peut être utilisé pour interroger l’état de l’appel et récupérer ses résultats. Pour plus d’informations, consultez XAsyncBlock.

Valeur de retour

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

Remarques

Pour récupérer la licence du module complémentaire ainsi que le résultat d’exécution de cette fonction, appelez XStoreQueryAddonLicensesResult après avoir appelé cette fonction. Pour récupérer le nombre de licences obtenues par cette fonction, appelez XStoreQueryAddonLicensesResultCount après avoir appelé cette fonction. La fonction de nombre de résultats est importante, car elle vous permet de déterminer la taille appropriée du tableau à passer à la fonction de résultat. L’extrait de code suivant montre un exemple de récupération des licences de modules complémentaires durables (sans package) que l’utilisateur possède ou pour lesquels il peut obtenir une 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
XStoreQueryAddonLicensesResult
XStoreQueryAddonLicensesResultCount
Last modified on October 6, 2026