Skip to main content

XStoreQueryAddOnLicensesAsync

Énumère les licences de tous les modules complémentaires durables qui sont rattachés à une licence de jeu numérique. Cela s’applique uniquement aux types durables sans package et ne peut être utilisé qu’avec une licence numérique, et non avec les licences sur disque. L’exécution de cette fonction avec une licence sur disque produira 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 sur disque, utilisez plutôt XStoreAcquireLicenseForDurablesAsync.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Le handle de contexte de magasin de l’utilisateur retourné par XStoreCreateContext. async   _Inout_
Type : XAsyncBlock*
Un XAsyncBlock qui définit le travail asynchrone en cours. Le XAsyncBlock peut servir à 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 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