StoreContext.RequestDownloadAndInstallStorePackagesAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Tenta baixar e instalar os pacotes DLC (conteúdo baixável) especificados 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. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Tenta baixar e instalar os pacotes DLC (conteúdo baixável) especificados para o aplicativo atual da Microsoft Store, com as opções de instalação especificadas. 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. |
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)
Tenta baixar e instalar os pacotes DLC (conteúdo baixável) especificados 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> ^ 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)Parâmetros
As IDs da Loja dos pacotes de complemento DLC a serem instalados.
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
Use esse método para baixar e instalar novos pacotes DLC para o aplicativo atual. Quando você chama esse método, o sistema operacional exibe uma caixa de diálogo que informa ao usuário que um pacote de aplicativo está disponível para baixar e instalar e solicita a permissão do usuário para prosseguir com a operação. Se o usuário não conceder permissão, a propriedade OverallState do valor retornado StorePackageUpdateResult terá o valor Cancelado. Para instalar silenciosamente um pacote de aplicativo sem exibir uma caixa de diálogo de notificação, use DownloadAndInstallStorePackagesAsync (esse método requer acesso a uma funcionalidade restrita).
A ID da Loja para um complemento DLC está disponível no Partner Center e também é retornada pela propriedade StoreId do StoreProduct que representa o complemento DLC. Para obter mais informações, consulte IDs da Loja.
Essa operação não será bloqueada. O objeto IAsyncOperationWithProgress retornado por esse método será concluído depois que os pacotes forem baixados e instalados.
O método que você atribui para lidar com notificações de progresso é chamado uma vez para cada etapa no processo de download e instalação de cada pacote nesta solicitação. O manipulador Progress recebe um argumento StorePackageUpdateStatus que fornece informações sobre o pacote que gerou a notificação de progresso.
Observação
Os pacotes DLC (conteúdo baixável) não estão disponíveis para todas as contas de desenvolvedor.
Confira também
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Criação de pacotes opcionais e conjunto relacionado
Aplica-se a
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)
Tenta baixar e instalar os pacotes DLC (conteúdo baixável) especificados para o aplicativo atual da Microsoft Store, com as opções de instalação especificadas. 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> ^ 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)Parâmetros
As IDs da Loja dos pacotes de complemento DLC a serem instalados.
- storePackageInstallOptions
- StorePackageInstallOptions
Um objeto que especifica as opções de instalação para a operação.
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.
Requisitos do Windows
| Família de dispositivos |
Windows 10, version 1803 (introduzida na 10.0.17134.0)
|
| API contract |
Windows.Services.Store.StoreContract (introduzida na v3.0)
|
Comentários
Use esse método para baixar e instalar novos pacotes DLC para o aplicativo atual. Essa sobrecarga fornece a opção de especificar se o sistema operacional pode ou não forçar o aplicativo a reiniciar depois de instalar os pacotes DLC definindo a propriedade AllowForcedAppRestart do parâmetro storePackageInstallOptions .
Quando você chama esse método, o sistema operacional exibe uma caixa de diálogo que informa ao usuário que um pacote de aplicativo está disponível para baixar e instalar e solicita a permissão do usuário para prosseguir com a operação. Se o usuário não conceder permissão, a propriedade OverallState do valor retornado StorePackageUpdateResult terá o valor Cancelado. Para instalar silenciosamente um pacote de aplicativo sem exibir uma caixa de diálogo de notificação, use DownloadAndInstallStorePackagesAsync (esse método requer acesso a uma funcionalidade restrita).
A ID da Loja para um complemento DLC está disponível no Partner Center e também é retornada pela propriedade StoreId do StoreProduct que representa o complemento DLC. Para obter mais informações, consulte IDs da Loja.
Essa operação não será bloqueada. O objeto IAsyncOperationWithProgress retornado por esse método será concluído depois que os pacotes forem baixados e instalados.
O método que você atribui para lidar com notificações de progresso é chamado uma vez para cada etapa no processo de download e instalação de cada pacote nesta solicitação. O manipulador Progress recebe um argumento StorePackageUpdateStatus que fornece informações sobre o pacote que gerou a notificação de progresso.
Observação
Os pacotes DLC não estão disponíveis para todas as contas de desenvolvedor.
Confira também
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Criação de pacotes opcionais e conjunto relacionado
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de