Skip to main content

XStoreQueryPackageUpdatesAsync

Récupère la liste des mises à jour disponibles pour les packages spécifiés dans l’argument. Utilisez cette liste pour télécharger et installer les mises à jour.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte du Store pour l’utilisateur, retourné par XStoreCreateContext. packageIdentifiers   _In_z_count_(packageIdentifiersCount)
Type : char**
Liste de chaînes d’identificateurs de package. Un identificateur de package identifie de façon unique un package du Microsoft Store. Pour plus d’informations sur les identificateurs de package, consultez Gérer le contenu téléchargeable (DLC) et ses licences. packageIdentifiersCount   _In_
Type : size_t
Nombre d’identificateurs dans packageIdentifiers. async   _Inout_
Type : XAsyncBlock*
Un XAsyncBlock qui définit le travail asynchrone. 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 l’identificateur de package du jeu en cours d’exécution, utilisez XPackageGetCurrentProcessPackageIdentifier ou utilisez XPackageEnumeratePackages pour obtenir les identificateurs de package du DLC et des jeux associés. Pour récupérer la liste des mises à jour disponibles et le résultat de l’exécution de cette fonction, appelez XStoreQueryPackageUpdatesResult après avoir appelé cette fonction. Pour obtenir le nombre de mises à jour à récupérer, appelez XStoreQueryPackageUpdatesResultCount après avoir appelé cette fonction. La fonction de nombre de résultats est importante, car elle vous permet de déterminer la taille appropriée du tableau à passer à la fonction de résultat. L’extrait de code suivant montre un exemple de récupération des mises à jour du jeu et des mises à jour facultatives pour les packages spécifié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 Series

Documentation conceptuelle

Voir aussi

XStore
XStoreQueryPackageUpdatesResult
XStoreQueryPackageUpdatesResultCount
Last modified on October 6, 2026