Skip to main content

XStoreQueryAssociatedProductsAsync

Obtient les informations de fiche du Store pour les produits que les utilisateurs peuvent acheter depuis le jeu en cours.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. 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. Pour plus d’informations, consultez Pagination. async   _Inout_
Type : XAsyncBlock*
XAsyncBlock définissant 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 XStoreQueryAssociatedProductsResult après avoir appelé cette fonction. XStoreQueryAssociatedProductsResult contient un XStoreProductQueryHandle que vous énumérez en appelant XStoreEnumerateProductsQuery. Vous ne pouvez pas connaître à l’avance le nombre de produits retournés par cette requête. Cette API retourne uniquement les produits que les utilisateurs peuvent parcourir dans le Microsoft Store ou acheter dans le jeu. Les résultats n’incluent aucun produit masqué, expiré ou retiré du Store. Si vous avez besoin des détails d’un tel produit, utilisez XStoreQueryProductsAsync en lui passant le Store ID du produit.

Pagination

Cette fonction retourne les produits sur plusieurs pages (jusqu’à maxItemsToRetrievePerPage éléments par page). Utilisez XStoreProductsQueryHasMorePages et XStoreProductsQueryNextPageAsync/XStoreProductsQueryNextPageResult pour traiter tous les résultats paginés. La pagination n’est terminée que lorsque XStoreProductsQueryHasMorePages retourne false.
La pagination peut se comporter différemment dans les sandbox et dans RETAIL. Dans une sandbox, les éléments s’accumulent jusqu’à maxItemsToRetrievePerPage avant qu’une page soit retournée. Dans RETAIL, il est courant que 0 à 1 élément soit retourné par page.Il est important que tous les jeux utilisant cette API implémentent et testent la pagination avant leur sortie.Pour tester le comportement de la pagination dans une sandbox, définissez temporairement maxItemsToRetrievePerPage sur une valeur inférieure au nombre de produits publiés dans votre sandbox. Pour tester dans RETAIL avant la sortie de votre jeu, publiez des produits à l’aide de l’option Enable Private Audience de la page « Pricing and availability » dans Partner Center. Pour tester dans RETAIL après la sortie de votre jeu, utilisez une version d’évaluation de package (package flight).
Le code suivant montre comment récupérer les résultats d’une requête de produits sur plusieurs pages. Veillez à transmettre le handle de requête tout au long de la récursion de pagination afin d’éviter les fuites.

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
XStoreQueryAssociatedProductsResult
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
Opérations de base du Store
Accorder aux joueurs l’accès au contenu des extensions
Last modified on October 6, 2026