Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
Valor de retorno
Esse método retorna os seguintes valores HRESULT e outros COM ou Windows
códigos de erro.
| Código de retorno | Description |
|---|---|
|
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. |
|
O WUA (Windows Update Agent) não tem atualizações na coleção. |
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
| Requirement | Value |
|---|---|
| Cliente mínimo suportado | Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho] |
| Servidor mínimo compatível | Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino | Windows |
| Header | wuapi.h |
| Library | Wuguid.lib |
| de DLL | Wuapi.dll |