Método IUpdateInstaller::BeginUninstall (wuapi.h)
Inicia uma desinstalação assíncrona das atualizações.
Sintaxe
HRESULT BeginUninstall(
[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 de desinstalação antes da desinstalação ser concluída.
[in] onCompleted
Uma interface IInstallationCompletedCallback que é chamada quando uma operação de instalação é concluída.
[in] state
O estado específico do chamador que a interface IInstallationJob da propriedade AsyncState retorna.
[out] retval
Uma interface IInstallationJob que contém as propriedades e os métodos que estão disponíveis para uma operação de desinstalação assíncrona iniciada.
Retornar valor
Esse método retorna os seguintes valores HRESULT e outros COM ou Windows
códigos de erro.
| Código de retorno | Descrição |
|---|---|
|
A remoção assíncrona de uma atualização foi iniciada com êxito. |
|
Não chame 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
| Requisito | Valor |
|---|---|
| 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 |