Compartilhar via


StoreContext.RequestDownloadStorePackageUpdatesAsync Método

Definição

Tenta baixar as atualizações de pacote especificadas para o aplicativo atual da Microsoft Store. Esse método também exibe uma caixa de diálogo de interface do usuário que solicita permissão para a operação.

Importante

Esse método deve ser chamado no thread da interface do usuário.

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)

Parâmetros

storePackageUpdates

IIterable<StorePackageUpdate>

IEnumerable<StorePackageUpdate>

O conjunto de objetos StorePackageUpdate que representam os pacotes atualizados a serem baixados.

Retornos

Um objeto que o chamador pode observar para acompanhar o progresso e a conclusão da operação. Após a conclusão bem-sucedida, o resultado é um objeto StorePackageUpdateResult que fornece informações sobre as atualizações do pacote.

Atributos

Exceções

Se a propriedade ErrorCode da exceção tiver o valor 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), isso indicará que o método não foi chamado no thread da interface do usuário. Se você estiver chamando esse método em um aplicativo da área de trabalho que usa o Ponte de Desktop, isso também pode indicar que você não configurou o <objeto xref:Windows.Services.Store.StoreContext?text=StoreContext> para especificar qual janela do aplicativo é a janela de proprietário para caixas de diálogo modais mostradas por esse método. Para obter mais informações, consulte este artigo.

Comentários

Para obter a lista de pacotes que têm atualizações disponíveis, use o método GetAppAndOptionalStorePackageUpdatesAsync . Depois de baixar os pacotes, você pode instalá-los usando o método RequestDownloadAndInstallStorePackageUpdatesAsync . Para obter mais informações sobre como usar esse método, incluindo um exemplo de código, consulte Baixar e instalar atualizações de pacote para seu aplicativo.

Essa operação não será bloqueada. O objeto IAsyncOperationWithProgress retornado por esse método será concluído depois que os pacotes de atualização forem baixados.

Quando você chama esse método, o sistema operacional exibe uma caixa de diálogo que informa ao usuário que uma atualização de aplicativo está disponível para download e solicita a permissão do usuário para prosseguir com o download. Se o usuário não conceder permissão para iniciar o download, a propriedade OverallState do valor retornado StorePackageUpdateResult terá o valor Cancelado.

O método que você atribui para lidar com notificações de progresso é chamado uma vez para cada etapa no processo de download de cada pacote nesta solicitação. O manipulador Progress recebe um argumento StorePackageUpdateStatus que fornece informações sobre o pacote de atualização que gerou a notificação de progresso.

Aplica-se a

Confira também