XStoreQueryAssociatedProductsForStoreIdAsync
Obtient les informations de fiche du Store pour les produits achetables liés à un produit cible spécifié par son ID Store.Syntaxe
Paramètres
storeContextHandle _In_Type : XStoreContextHandle Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. storeId _In_
Type : const char* ID Store du produit pour lequel les produits associés sont récupérés. productKinds _In_
Type : XStoreProductKind Type de produits à retourner. maxItemsToRetrievePerPage _In_
Type : uint32_t Nombre maximal d’éléments à récupérer par page. Le nombre d’éléments retournés par page peut varier de 0 à
maxItemsToRetrievePerPage.
async _Inout_Type : XAsyncBlock* XAsyncBlock qui définit le travail asynchrone en cours. Utilisez le XAsyncBlock 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 obtenir les informations de fiche du Store et le résultat d’exécution de cette fonction, appelez XStoreQueryAssociatedProductsForStoreIdResult après avoir appelé cette fonction. XStoreQueryAssociatedProductsForStoreIdResult contient unXStoreProductQueryHandle qui est énuméré en appelant XStoreEnumerateProductsQuery.
Cette API prend en charge le même modèle de pagination que celui décrit dans XStoreQueryAssociatedProductsAsync.La pagination peut se comporter différemment entre les bacs à sable et RETAIL.
Vérifiez votre implémentation de la pagination et assurez-vous de la tester dans RETAIL avant la sortie.Pour plus d’informations, consultez Pagination.
-
Les développeurs exécutent
XPackageEnumeratePackagespour énumérer les produits XPackageKind::Game installés, puis, pour l’un de ces jeux, ils exécutentXStoreQueryAssociatedProductsForStoreIdAsyncen utilisant le storeId obtenu à partir desXPackageDetails. Les développeurs exécutentXPackageEnumeratePackagespour XPackageKind::Content afin d’énumérer le contenu téléchargeable (DLC) installé. Les résultats de l’énumération du contenu et de la requête de produits sont recoupés, ce qui permet aux développeurs d’identifier quels DLC sont installés pour le jeu en question. -
Les développeurs exécutent
XStoreQueryAssociatedProductsAsyncpour obtenir la liste des produits achetables associés au jeu en cours. Ensuite, en utilisant le storeId duXStoreProductdu jeu cible, les développeurs exécutentXStoreQueryAssociatedProductsForStoreIdAsyncpour déterminer quels DLC lui sont associés.
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
Voir aussi
XStoreXStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
