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 unXStoreProductQueryHandle 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.
-
Les développeurs exécutent
XPackageEnumeratePackagespour énumérer les produits XPackageKind::Game installés, puis, pour l’un de ces jeux, ils exécutentXStoreQueryAssociatedProductsForStoreIdAsyncà l’aide du storeId obtenu à partir deXPackageDetails. Les développeurs exécutentXPackageEnumeratePackagespour 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
XStoreQueryAssociatedProductsAsyncpour obtenir la liste des produits achetables associés au jeu en cours. Ensuite, à l’aide du storeId provenant duXStoreProductdu jeu cible, ils 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
