StoreContext.RequestDownloadStorePackageUpdatesAsync 方法

  • 参考

定义

命名空间:
Windows.Services.Store
编辑

尝试从 Microsoft Store 下载当前应用的指定包更新。 此方法还显示请求操作权限的 UI 对话框。

重要

必须在 UI 线程上调用此方法。

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)

参数

storePackageUpdates

IIterable<StorePackageUpdate>

IEnumerable<StorePackageUpdate>

StorePackageUpdate 对象集，这些对象表示要下载的更新包。

返回

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

一个 对象，调用方可以观察该对象来跟踪操作的进度和完成情况。 成功完成后，结果为 StorePackageUpdateResult 对象，该对象提供有关包更新的信息。

属性
RemoteAsyncAttribute

例外

COMException

如果异常的 ErrorCode 属性的值0x80070578 (ERROR_INVALID_WINDOW_HANDLE) ，则表示未在 UI 线程上调用该方法。 如果在使用 桌面桥 的桌面应用程序中调用此方法，这可能还可能表示未配置 <xref：Windows.Services.Store.StoreContext？text=StoreContext> 对象，以指定哪个应用程序窗口是此方法显示的模式对话框的所有者窗口。 有关详细信息，请参阅此文章。

注解

若要获取具有可用更新的包的列表，请使用 GetAppAndOptionalStorePackageUpdatesAsync 方法。 下载包后，可以使用 RequestDownloadAndInstallStorePackageUpdatesAsync 方法安装它们。 有关使用此方法的详细信息（包括代码示例），请参阅 下载并安装应用的包更新。

此操作不会阻止。 此方法返回的 IAsyncOperationWithProgress 对象将在下载更新包后完成。

调用此方法时，OS 将显示一个对话框，告知用户应用更新可供下载，并请求用户继续下载的权限。 如果用户未授予开始下载的权限，StorePackageUpdateResult 返回值的 OverallState 属性具有值 Canceled。

对于此请求中每个包的下载过程中的每个步骤，将调用分配给处理 进度 通知的方法一次。 Progress 处理程序接收 StorePackageUpdateStatus 参数，该参数提供有关引发进度通知的更新包的信息。

适用于

另请参阅