Freigeben über


StoreContext.RequestDownloadAndInstallStorePackagesAsync Methode

Definition

Überlädt

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

Versucht, die angegebenen DLC-Pakete (Downloadable Content) für die aktuelle App aus dem Microsoft Store herunterzuladen und zu installieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

Versucht, die angegebenen DLC-Pakete (Downloadable Content) für die aktuelle App mit den angegebenen Installationsoptionen aus dem Microsoft Store herunterzuladen und zu installieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

Versucht, die angegebenen DLC-Pakete (Downloadable Content) für die aktuelle App aus dem Microsoft Store herunterzuladen und zu installieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = RequestDownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);
function requestDownloadAndInstallStorePackagesAsync(storeIds)
Public Function RequestDownloadAndInstallStorePackagesAsync (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 zu installierenden DLC-Add-On-Pakete.

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

Ausnahmen

Wenn die ErrorCode-Eigenschaft der Ausnahme den Wert 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) aufweist, gibt dies an, dass die Methode im UI-Thread nicht aufgerufen wurde. Wenn Sie diese Methode in einer Desktopanwendung aufrufen, die die Desktop-Brücke verwendet, kann dies auch darauf hinweisen, dass Sie das <xref:Windows.Services.Store.StoreContext?text=StoreContext-Objekt> nicht konfiguriert haben, um anzugeben, welches Anwendungsfenster das Besitzerfenster für modale Dialoge ist, die von dieser Methode angezeigt werden. hier finden Sie weitere Informationen

Hinweise

Verwenden Sie diese Methode, um neue DLC-Pakete für die aktuelle App herunterzuladen und zu installieren. Wenn Sie diese Methode aufrufen, zeigt das Betriebssystem ein Dialogfeld an, das dem Benutzer mitteilt, dass ein App-Paket zum Herunterladen und Installieren verfügbar ist, und fragt die Berechtigung des Benutzers, mit dem Vorgang fortzufahren. Wenn der Benutzer keine Berechtigung erteilt, weist die OverallState-Eigenschaft des StorePackageUpdateResult-Rückgabewerts den Wert Canceled auf. Um ein App-Paket unbeaufsichtigt zu installieren, ohne ein Benachrichtigungsdialogfeld anzuzeigen, verwenden Sie DownloadAndInstallStorePackagesAsync (diese Methode erfordert Zugriff auf eine eingeschränkte Funktion).

Die Store-ID für ein DLC-Add-On ist im 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.

Hinweis

DLC-Pakete (Downloadable Content) sind nicht für alle Entwicklerkonten verfügbar.

Weitere Informationen

Gilt für:

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

Versucht, die angegebenen DLC-Pakete (Downloadable Content) für die aktuelle App mit den angegebenen Installationsoptionen aus dem Microsoft Store herunterzuladen und zu installieren. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

public:
 virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds, StorePackageInstallOptions ^ storePackageInstallOptions) = RequestDownloadAndInstallStorePackagesAsync;
/// [Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds, StorePackageInstallOptions const& storePackageInstallOptions);
[Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds, StorePackageInstallOptions storePackageInstallOptions);
function requestDownloadAndInstallStorePackagesAsync(storeIds, storePackageInstallOptions)
Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String), storePackageInstallOptions As StorePackageInstallOptions) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)

Parameter

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Die Store-IDs der zu installierenden DLC-Add-On-Pakete.

storePackageInstallOptions
StorePackageInstallOptions

Ein -Objekt, das die Installationsoptionen für den Vorgang angibt.

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

Ausnahmen

Wenn die ErrorCode-Eigenschaft der Ausnahme den Wert 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) aufweist, gibt dies an, dass die Methode im UI-Thread nicht aufgerufen wurde. Wenn Sie diese Methode in einer Desktopanwendung aufrufen, die die Desktop-Brücke verwendet, kann dies auch darauf hinweisen, dass Sie das <xref:Windows.Services.Store.StoreContext?text=StoreContext-Objekt> nicht konfiguriert haben, um anzugeben, welches Anwendungsfenster das Besitzerfenster für modale Dialoge ist, die von dieser Methode angezeigt werden. hier finden Sie weitere Informationen

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)

Hinweise

Verwenden Sie diese Methode, um neue DLC-Pakete für die aktuelle App herunterzuladen und zu installieren. Diese Überladung bietet die Möglichkeit, anzugeben, ob das Betriebssystem den Neustart der App nach der Installation der DLC-Pakete erzwingen kann, indem die AllowForcedAppRestart-Eigenschaft des parameters storePackageInstallOptions festgelegt wird.

Wenn Sie diese Methode aufrufen, zeigt das Betriebssystem ein Dialogfeld an, das dem Benutzer mitteilt, dass ein App-Paket zum Herunterladen und Installieren verfügbar ist, und fragt die Berechtigung des Benutzers, mit dem Vorgang fortzufahren. Wenn der Benutzer keine Berechtigung erteilt, weist die OverallState-Eigenschaft des StorePackageUpdateResult-Rückgabewerts den Wert Canceled auf. Um ein App-Paket unbeaufsichtigt zu installieren, ohne ein Benachrichtigungsdialogfeld anzuzeigen, verwenden Sie DownloadAndInstallStorePackagesAsync (diese Methode erfordert Zugriff auf eine eingeschränkte Funktion).

Die Store-ID für ein DLC-Add-On ist im 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.

Hinweis

DLC-Pakete sind nicht für alle Entwicklerkonten verfügbar.

Weitere Informationen

Gilt für: