StoreContext.RequestDownloadAndInstallStorePackagesAsync 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.
Ü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
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
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Optionale Pakete und die Erstellung zugehöriger Sets
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
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
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Optionale Pakete und die Erstellung zugehöriger Sets