Compartilhar via


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

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

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

Confira também

IUpdateInstaller