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 SeriesDocumentation conceptuelle
- Opérations de base du Store
- Accorder aux joueurs l’accès au contenu des extensions
- Limitation précise du débit pour les API du Microsoft Store
Voir aussi
XStore XStoreQueryProductsResultXStoreQueryAssociatedProductsAsync
XStoreQueryEntitledProductsAsync
XStoreQueryProductsAsync
XStoreQueryProductForCurrentGameAsync
XStoreQueryProductForPackageAsync
Opérations de base du Store
Accorder aux joueurs l’accès au contenu des extensions
