Método IUpdateInstaller::BeginInstall (wuapi.h)

Inicia uma instalação assíncrona das atualizações.

Sintaxe

HRESULT BeginInstall(
  [in]  IUnknown         *onProgressChanged,
  [in]  IUnknown         *onCompleted,
  [in]  VARIANT          state,
  [out] IInstallationJob **retval
);

Parâmetros

[in] onProgressChanged

Uma interface IInstallationProgressChangedCallback que é chamada periodicamente para alterações de progresso da instalação antes da conclusão da instalação.

[in] onCompleted

Uma interface IInstallationCompletedCallback que é chamada quando uma operação de instalação é concluída.

[in] state

O estado específico do chamador retornado pela propriedade AsyncState da interface IInstallationJob .

[out] retval

Uma interface IInstallationJob que contém as propriedades e os métodos que estão disponíveis para uma operação de instalação assíncrona iniciada.

Valor de retorno

Esse método retorna os seguintes valores HRESULT e outros COM ou Windows

códigos de erro.

Observações

Se você chamar esse método de uma linguagem de script, defina o parâmetro onProgressChanged como o identificador de um objeto de Automação com um DSIPID (identificador de expedição) de zero (0) que implementa a rotina de retorno de chamada. Faça a mesma coisa para o parâmetro onCompleted .

Esse método retornará WU_E_NO_UPDATE se a propriedade Updates do IUpdateInstaller não estiver definida. Esse método também retornará WU_E_NO_UPDATE se a propriedade Updates estiver definida como uma coleção vazia.

Ao usar qualquer API WUA assíncrona em seu aplicativo, talvez seja necessário implementar um mecanismo de tempo limite. Para obter mais informações sobre como executar operações WUA assíncronas, consulte Diretrizes para operações assíncronas de WUA.

Requirements

Consulte também

IUpdateInstaller