StoreContext.DownloadAndInstallStorePackagesAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Lädt die angegebenen DLC-Pakete (Downloadable Content) für die aktuelle App aus dem Microsoft Store herunter und installiert sie, ohne dass dem Benutzer ein Dialogfeld zur Benachrichtigungsbenutzeroberfläche angezeigt wird.
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)Parameter
Die Store-IDs der Add-Ons, die den DLC-Paketen entsprechen, die für die aktuelle App installiert werden sollen.
Gibt zurück
Ein Objekt, das der Aufrufer beobachten kann, um den Fortschritt und die Vervollständigung für den Vorgang nachzuverfolgen. Nach erfolgreicher Fertigstellung ist das Ergebnis ein StorePackageUpdateResult-Objekt , das Informationen zu den Paketupdates bereitstellt.
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10, version 1803 (eingeführt in 10.0.17134.0)
|
| API contract |
Windows.Services.Store.StoreContract (eingeführt in v3.0)
|
| App-Funktionen |
storePackageManagement
|
Hinweise
Verwenden Sie diese Methode, um neue DLC-Pakete für die aktuelle App herunterzuladen und zu installieren. Wenn Sie diese Methode aufrufen, lädt das Betriebssystem die Pakete automatisch herunter und installiert sie, ohne dass ein Benachrichtigungsdialogfeld angezeigt wird. Für diese Methode ist die eingeschränkte funktion storePackageManagement erforderlich, um diesen Vorgang auszuführen. Wenn Sie keinen Zugriff auf diese eingeschränkte Funktion haben, können Sie stattdessen die RequestDownloadAndInstallStorePackagesAsync-Methoden verwenden (diese Methoden zeigen ein Benachrichtigungsdialogfeld an, in dem die Berechtigung des Benutzers zum Installieren des Pakets angefordert wird).
Hinweis
DLC-Pakete sind nicht für alle Entwicklerkonten verfügbar.
Hinweis
Die eingeschränkte storePackageManagement-Funktion ist nur für Desktopanwendungen und Spiele verfügbar, die die Desktop-Brücke verwenden, sowie für Xbox-Spiele, die XVC-Pakete verwenden und im Rahmen eines verwalteten Partnerprogramms wie dem ID@Xbox-Programm entwickelt werden. Diese Funktion ist für diese Anwendungen und Spiele standardmäßig vorhanden.
Die Store-ID für ein Add-On ist in Partner Center verfügbar und wird auch von der StoreId-Eigenschaft des StoreProduct zurückgegeben, das das DLC-Add-On darstellt. Weitere Informationen finden Sie unter Store-IDs.
Dieser Vorgang wird nicht blockiert. Das von dieser Methode zurückgegebene IAsyncOperationWithProgress-Objekt wird abgeschlossen, nachdem die Pakete heruntergeladen und installiert wurden.
Die Methode, die Sie zum Verarbeiten von Statusbenachrichtigungen zuweisen, wird für jeden Schritt im Download- und Installationsprozess für jedes Paket in dieser Anforderung einmal aufgerufen. Der Progress-Handler empfängt ein StorePackageUpdateStatus-Argument , das Informationen zu dem Paket bereitstellt, das die Statusbenachrichtigung ausgelöst hat.