Skip to main content

​
XStoreDownloadPackageUpdatesAsync

Cette API ne fonctionne pas comme prévu, car les mises à jour sur XBOX sont installées au fur et à mesure de leur téléchargement. Si la mise à jour concerne le jeu, celui-ci se termine. Si la mise à jour concerne un DLC, le jeu se termine si le package de DLC est actuellement monté.Utilisez plutôt XStoreDownloadAndInstallPackageUpdatesAsync.
Télécharge les mises à jour des packages spécifiés sans les installer. Cela permet à votre jeu de contrôler le moment de l’installation des mises à jour, afin d’éviter que le jeu ne s’arrête pendant que l’utilisateur joue.

​
Syntaxe

​
Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle Handle de contexte de Store de l’utilisateur, renvoyé par XStoreCreateContext. packageIdentifiers   _In_z_count_(packageIdentifiersCount)
Type : char** Liste d’identificateurs de package. Un identificateur de package est une chaîne d’ID unique pour un package du Microsoft Store. Pour plus d’informations sur les identificateurs de package, consultez Gérer et accorder des licences pour le contenu téléchargeable (DLC). packageIdentifiersCount   _In_
Type : size_t Nombre d’identificateurs dans packageIdentifiers. async   _Inout_
Type : XAsyncBlock* XAsyncBlock définissant le travail asynchrone en cours. Le XAsyncBlock peut être utilisé pour interroger l’état de l’appel et récupérer ses résultats. Pour plus d’informations, consultez XAsyncBlock.

​
Valeur de retour

Type : HRESULT Renvoie S_OK en cas de réussite ; sinon, renvoie un code d’erreur.

​
Remarques

Cette fonction télécharge uniquement une mise à jour, mais ne l’installe pas. Pour télécharger et installer une mise à jour en un seul appel, utilisez la fonction XStoreDownloadAndInstallPackageUpdatesAsync. Pour récupérer le résultat de cette fonction, appelez XStoreDownloadPackageUpdatesResult après avoir appelé cette fonction. Pour obtenir un exemple d’utilisation, consultez XStoreQueryGameAndDlcPackageUpdatesAsync. Lorsque cette API est appelée depuis un jeu en cours d’exécution, les téléchargements sont considérés comme prioritaires et sont placés au début de la file d’attente, dans l’ordre dans lequel ils sont spécifiés dans le paramètre storeIds de cette API.

​
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

​
Voir aussi

XStore
XStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync
Last modified on October 6, 2026