Compartilhar via


StoreContext.RequestDownloadAndInstallStorePackagesAsync Método

Definição

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

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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

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

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

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

Aplica-se a