Skip to main content

XStoreQueryProductsAsync

Retourne les informations de fiche pour les produits spécifiés qui sont associés au jeu en cours, que ces produits puissent être achetés ou non dans le jeu.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. productKinds   _In_
Type : XStoreProductKind
Types de produits à retourner. storeIds   _In_z_count_(storeIdsCount)
Type : char**
Identificateurs Store des produits à récupérer. storeIdsCount   _In_
Type : size_t
Nombre de produits dans la liste storeIds. Ce nombre ne doit pas dépasser 100. actionFilters   _In_opt_z_count_(actionFiltersCount)
Type : char**
Restreint les résultats selon une action stockée dans le document du produit. Par défaut, cette API retourne tous les produits, même s’ils ne peuvent pas être achetés, mais vous pouvez utiliser des filtres d’action pour restreindre les résultats. Par exemple, utilisez “Purchase” si vous voulez uniquement les produits pouvant être achetés, ou “License” si vous voulez uniquement les produits pouvant faire l’objet d’une licence. Les autres filtres d’action comprennent “Fulfill”, “Browse”, “Curate”, “Details” et “Redeem”. actionFiltersCount   _In_
Type : size_t
Nombre de filtres dans actionFilters. async   _Inout_
Type : XAsyncBlock*
Un XAsyncBlock définissant le travail asynchrone en cours. Utilisez le XAsyncBlock pour vérifier l’état de l’appel et obtenir les résultats. Pour plus d’informations, consultez XAsyncBlock.

Valeur de retour

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

Remarques

Appelez XStoreQueryProductsResult pour récupérer les informations de fiche et le résultat de l’exécution de cette fonction. Cette API échoue si vous fournissez plus de 100 storeIDs dans la requête. Si vous travaillez avec un catalogue volumineux, limitez chaque requête à moins de 100 produits. Pour obtenir les détails de tous les produits que les joueurs peuvent acheter dans le jeu en cours, utilisez plutôt XStoreQueryAssociatedProductsAsync. L’extrait de code suivant montre un exemple de récupération des informations de fiche pour les produits spécifiés qui sont associés au jeu en cours.

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 XStoreQueryProductsResult
XStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
Opérations de base du Store
Accorder aux joueurs l’accès au contenu des extensions
Last modified on October 6, 2026