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 Store ID.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. storeId   _In_
Type : const char*
Store ID 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 ses résultats. Pour plus d’informations, consultez XAsyncBlock.

Valeur renvoyée

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

Remarques

Pour obtenir les informations de fiche du Store et le résultat de l’exécution de cette fonction, appelez XStoreQueryAssociatedProductsForStoreIdResult après avoir appelé cette fonction. XStoreQueryAssociatedProductsForStoreIdResult contient un XStoreProductQueryHandle qui s’énumère 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 dans les sandbox et dans RETAIL. Vérifiez votre implémentation de la pagination et veillez à 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 retournés par cette requête. Utilisez cette API pour trouver les extensions associées à un produit cible à l’aide de son Store ID. 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 savoir à 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 à l’aide du storeId obtenu à partir de XPackageDetails. Les développeurs exécutent XPackageEnumeratePackages pour XPackageKind::Content afin d’énumérer les DLC installés. 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 les DLC installés pour ce jeu spécifique.
  • Les développeurs exécutent XStoreQueryAssociatedProductsAsync pour obtenir la liste des produits achetables associés au jeu en cours. Ensuite, à l’aide du storeId provenant du XStoreProduct du jeu cible, ils exécutent XStoreQueryAssociatedProductsForStoreIdAsync pour déterminer quels DLC lui sont associés.
L’extrait de code suivant montre un exemple de requête des produits associés à un produit cible à l’aide de son Store ID. 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