Skip to main content

XStoreDownloadAndInstallPackagesAsync

Télécharge et installe les packages du Store spécifiés.

Syntaxe

Paramètres

storeContextHandle   _In_
Type : XStoreContextHandle
Handle de contexte de Store de l’utilisateur, renvoyé par XStoreCreateContext. storeIds   _In_z_count_(storeIdsCount)
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 et accorder des licences pour le contenu téléchargeable (DLC). storeIdsCount   _In_
Type : size_t
Nombre d’ID dans storeIds. 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 Code de réussite ou d’erreur HRESULT.

Remarques

Pour récupérer le résultat du téléchargement et de l’installation de cette fonction, appelez XStoreDownloadAndInstallPackagesResult après avoir appelé cette fonction. Pour récupérer le nombre d’éléments téléchargés et installés, appelez XStoreDownloadAndInstallPackagesResultCount 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. 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. L’extrait de code suivant montre un exemple de téléchargement et d’installation de packages du Store.

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
XStoreDownloadAndInstallPackagesResult
XStoreDownloadAndInstallPackagesResultCount
Last modified on October 6, 2026