StoreContext.RequestDownloadStorePackageUpdatesAsync 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.
Versucht, die angegebenen Paketupdates für die aktuelle App aus dem Microsoft Store herunterzuladen. 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> ^ RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate ^> ^ storePackageUpdates) = RequestDownloadStorePackageUpdatesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate> const& storePackageUpdates);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IEnumerable<StorePackageUpdate> storePackageUpdates);function requestDownloadStorePackageUpdatesAsync(storePackageUpdates)Public Function RequestDownloadStorePackageUpdatesAsync (storePackageUpdates As IEnumerable(Of StorePackageUpdate)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parameter
- storePackageUpdates
Der Satz von StorePackageUpdate-Objekten , die die aktualisierten Pakete darstellen, die heruntergeladen 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
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 die GetAppAndOptionalStorePackageUpdatesAsync-Methode , um die Liste der Verfügbaren Pakete abzurufen. Nachdem Sie die Pakete heruntergeladen haben, können Sie sie mithilfe der RequestDownloadAndInstallStorePackageUpdatesAsync-Methode installieren. Weitere Informationen zur Verwendung dieser Methode, einschließlich eines Codebeispiels, finden Sie unter Herunterladen und Installieren von Paketupdates für Ihre App.
Dieser Vorgang wird nicht blockiert. Das von dieser Methode zurückgegebene IAsyncOperationWithProgress-Objekt wird nach dem Herunterladen der Updatepakete abgeschlossen.
Wenn Sie diese Methode aufrufen, zeigt das Betriebssystem ein Dialogfeld an, das dem Benutzer mitteilt, dass ein App-Update zum Herunterladen verfügbar ist, und fragt die Berechtigung des Benutzers, mit dem Download fortzufahren. Wenn der Benutzer keine Berechtigung zum Starten des Downloads erteilt, weist die OverallState-Eigenschaft des StorePackageUpdateResult-Rückgabewerts den Wert Canceled auf.
Die Methode, die Sie zum Verarbeiten von Statusbenachrichtigungen zuweisen, wird für jeden Schritt im Downloadprozess für jedes Paket in dieser Anforderung einmal aufgerufen. Der Progress-Handler empfängt ein StorePackageUpdateStatus-Argument , das Informationen zum Updatepaket bereitstellt, das die Statusbenachrichtigung ausgelöst hat.