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, le jeu se terminera. Si la mise à jour concerne du DLC, le jeu se terminera 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 se ferme pendant que l’utilisateur joue.

​
Syntaxe

​
Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle Le handle de contexte de magasin de l’utilisateur retourné par XStoreCreateContext. packageIdentifiers   _In_z_count_(packageIdentifiersCount)
Type : char** Liste d’identificateurs de packages. 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 packages, consultez Gérer et octroyer des licences pour le contenu téléchargeable (DLC). packageIdentifiersCount   _In_
Type : size_t Le nombre d’identificateurs dans packageIdentifiers. async   _Inout_
Type : XAsyncBlock* Un XAsyncBlock qui définit le travail asynchrone en cours. Le XAsyncBlock peut servir à 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 Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur.

​
Remarques

Cette fonction télécharge seulement 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. Consultez XStoreQueryGameAndDlcPackageUpdatesAsync pour un exemple d’utilisation. Lorsque cette API est appelée à partir d’un jeu en cours d’exécution, les téléchargements sont considérés comme hautement prioritaires et sont placés au début de la file d’attente, dans l’ordre où 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