Skip to main content

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 un XStoreProductQueryHandle 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.
Vous ne pouvez pas connaître à l’avance le nombre de produits que cette requête retourne. Utilisez l’API pour trouver les extensions associées à un produit cible à l’aide de son ID Store. Cette capacité est particulièrement utile pour les hubs de jeux de franchise. Un hub de jeux de franchise peut énumérer les extensions de plusieurs jeux, mais il ne peut pas déterminer à quel jeu ces extensions sont associées. Exemples de scénarios d’utilisation :
  • Les développeurs exécutent XPackageEnumeratePackages pour énumérer les produits XPackageKind::Game installés, puis, pour l’un de ces jeux, ils exécutent XStoreQueryAssociatedProductsForStoreIdAsync en utilisant le storeId obtenu à partir des XPackageDetails. Les développeurs exécutent XPackageEnumeratePackages pour 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 XStoreQueryAssociatedProductsAsync pour obtenir la liste des produits achetables associés au jeu en cours. Ensuite, en utilisant le storeId du XStoreProduct du jeu cible, les développeurs exécutent XStoreQueryAssociatedProductsForStoreIdAsync pour déterminer quels DLC lui sont associés.
L’extrait de code suivant montre un exemple de requête de produits associés à un produit cible à l’aide de son ID Store. Les résultats sont traités sur plusieurs pages.

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
XStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
Last modified on October 6, 2026