StoreContext.RequestDownloadStorePackageUpdatesAsync Метод

  • Ссылка

Определение

Пространство имен:
Windows.Services.Store
Изменить

Пытается скачать указанные обновления пакета для текущего приложения из Microsoft Store. Этот метод также отображает диалоговое окно пользовательского интерфейса, которое запрашивает разрешение для операции.

Важно!

Этот метод должен вызываться в потоке пользовательского интерфейса.

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), это означает, что метод не был вызван в потоке пользовательского интерфейса. Если вы вызываете этот метод в классическом приложении, которое использует мост для классических приложений, это также может означать, что вы не настроили <объект xref:Windows.Services.Store.StoreContext?text=StoreContext>, чтобы указать, какое окно приложения является окном-владельцем для модальных диалогов, отображаемых этим методом. Дополнительные сведения см. в этой статье.

Комментарии

Чтобы получить список пакетов с доступными обновлениями, используйте метод GetAppAndOptionalStorePackageUpdatesAsync . После скачивания пакетов их можно установить с помощью метода RequestDownloadAndInstallStorePackageUpdatesAsync . Дополнительные сведения об использовании этого метода, включая пример кода, см. в разделе Скачивание и установка обновлений пакета для приложения.

Эта операция не блокируется. Объект IAsyncOperationWithProgress , возвращаемый этим методом, завершится после загрузки пакетов обновления.

При вызове этого метода ОПЕРАЦИОННая система отображает диалоговое окно, в котором сообщается, что доступно обновление приложения для скачивания, и запрашивается разрешение пользователя на продолжение скачивания. Если пользователь не предоставляет разрешение на запуск скачивания, свойство OverallState возвращаемого значения StorePackageUpdateResult имеет значение Canceled.

Метод, назначаемый для обработки уведомлений о ходе выполнения, вызывается один раз для каждого шага в процессе скачивания для каждого пакета в этом запросе. Обработчик хода выполнения получает аргумент StorePackageUpdateStatus , который предоставляет сведения о пакете обновления, вызвавшим уведомление о ходе выполнения.

Применяется к

См. также раздел