StoreContext.DownloadAndInstallStorePackagesAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Télécharge et installe les packages de contenu téléchargeable (DLC) spécifiés pour l’application actuelle à partir du Microsoft Store sans afficher de boîte de dialogue d’interface utilisateur de notification à l’utilisateur.
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ DownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = DownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);function downloadAndInstallStorePackagesAsync(storeIds)Public Function DownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Paramètres
ID store des modules complémentaires qui correspondent aux packages DLC à installer pour l’application actuelle.
Retours
Objet que l’appelant peut observer pour suivre la progression et l’achèvement de l’opération. Une fois l’exécution réussie, le résultat est un objet StorePackageUpdateResult qui fournit des informations sur les mises à jour du package.
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10, version 1803 (introduit dans 10.0.17134.0)
|
| API contract |
Windows.Services.Store.StoreContract (introduit dans v3.0)
|
| Fonctionnalités de l’application |
storePackageManagement
|
Remarques
Utilisez cette méthode pour télécharger et installer de nouveaux packages DLC pour l’application actuelle. Lorsque vous appelez cette méthode, le système d’exploitation télécharge et installe les packages en mode silencieux sans afficher de boîte de dialogue de notification. Cette méthode nécessite la fonctionnalité storePackageManagement restreinte pour effectuer cette opération. Si vous n’avez pas accès à cette fonctionnalité restreinte, vous pouvez utiliser les méthodes RequestDownloadAndInstallStorePackagesAsync à la place (ces méthodes affichent une boîte de dialogue de notification qui demande à l’utilisateur l’autorisation d’installer le package).
Notes
Les packages DLC ne sont pas disponibles pour tous les comptes de développeur.
Notes
La fonctionnalité storePackageManagement restreint n’est disponible que pour les applications de bureau et les jeux qui utilisent l’Pont du bureau et les jeux Xbox qui utilisent des packages XVC et qui sont développés dans le cadre d’un programme partenaire géré, tel que le programme ID@Xbox. Ces applications et jeux ont cette fonctionnalité par défaut.
L’ID Store d’un module complémentaire est disponible dans l’Espace partenaires, et il est également retourné par la propriété StoreId du StoreProduct qui représente le module complémentaire DLC. Pour plus d’informations, consultez Store IDs.
Cette opération ne se bloque pas. L’objet IAsyncOperationWithProgress retourné par cette méthode se termine une fois les packages téléchargés et installés.
La méthode que vous attribuez pour gérer les notifications de progression est appelée une fois pour chaque étape du processus de téléchargement et d’installation pour chaque package de cette demande. Le gestionnaire Progress reçoit un argument StorePackageUpdateStatus qui fournit des informations sur le package qui a déclenché la notification de progression.