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 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 |
|---|---|
|
A instalação assíncrona de uma atualização foi iniciada com êxito. |
|
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. |
|
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 |