Partager via


StoreContext.DownloadAndInstallStorePackagesAsync Méthode

Définition

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

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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.

S’applique à

Voir aussi