Share via

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

  • Artigo

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 no 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 retornado

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

códigos de erro.

Código de retorno Descrição
S_OK
 A instalação assíncrona de uma atualização foi iniciada com êxito.
WU_E_INSTALL_NOT_ALLOWED
 Não é possível chamar esse método quando o instalador estiver instalando ou removendo uma atualização.

Chame esse método somente quando a propriedade IsBusy da interface IUpdateInstaller retornar VARIANT_FALSE.
WU_E_NO_UPDATE
 Windows Update Agent (WUA) não tem atualizações na coleção.

Comentários

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

Esse método retornará WU_E_NO_UPDATE se a propriedade Atualizações de IUpdateInstaller não estiver definida. Esse método também retornará WU_E_NO_UPDATE se a propriedade Atualizações 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 WUA assíncronas.

Requisitos

   
Cliente mínimo com suporte Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wuapi.h
Biblioteca Wuguid.lib
DLL Wuapi.dll

Confira também

IUpdateInstaller