StoreContext.DownloadAndInstallStorePackagesAsync Methode

  • Referenz

Definition

Namespace:
Windows.Services.Store
Bearbeiten

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

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Die Store-IDs der Add-Ons, die den DLC-Paketen entsprechen, die für die aktuelle App installiert werden sollen.

Gibt zurück

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

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
RemoteAsyncAttribute

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.

Gilt für:

Weitere Informationen