Compartir a través de

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

  • Artículo

Inicia una desinstalación asincrónica de las actualizaciones.

Sintaxis

HRESULT BeginUninstall(
  [in]  IUnknown         *onProgressChanged,
  [in]  IUnknown         *onCompleted,
  [in]  VARIANT          state,
  [out] IInstallationJob **retval
);

Parámetros

[in] onProgressChanged

Interfaz IInstallationProgressChangedCallback a la que se llama periódicamente para los cambios de progreso de desinstalación antes de que se complete la desinstalación.

[in] onCompleted

Interfaz IInstallationCompletedCallback a la que se llama cuando se completa una operación de instalación.

[in] state

Estado específico del autor de la llamada que devuelve la interfaz IInstallationJob de la propiedad AsyncState.

[out] retval

Interfaz IInstallationJob que contiene las propiedades y métodos que están disponibles para una operación de desinstalación asincrónica que se inició.

Valor devuelto

Este método devuelve los siguientes valores HRESULT y otros VALORES COM o Windows.

códigos de error.

Código devuelto Descripción
S_OK
 La eliminación asincrónica de una actualización se inició correctamente.
WU_E_INSTALL_NOT_ALLOWED
 No llame a este método cuando el instalador esté instalando o quitando una actualización.

Llame a este método solo cuando la propiedad IsBusy de la interfaz IUpdateInstaller devuelva VARIANT_FALSE.
WU_E_NO_UPDATE
 Windows Update Agent (WUA) no tiene actualizaciones en la colección.

Comentarios

Si llama a este método desde un lenguaje de scripting, establezca el parámetro onProgressChanged en el identificador de un objeto Automation con un identificador de envío (DSIPID) de cero (0) que implementa la rutina de devolución de llamada. Haga lo mismo para el parámetro onCompleted .

Este método devuelve WU_E_NO_UPDATE si no se establece la propiedad Novedades de IUpdateInstaller. Este método también devuelve WU_E_NO_UPDATE si la propiedad Novedades está establecida en una colección vacía.

Al usar cualquier API asincrónica de WUA en la aplicación, es posible que tenga que implementar un mecanismo de tiempo de espera. Para obtener más información sobre cómo realizar operaciones asincrónicas de WUA, consulta Directrices para operaciones asincrónicas de WUA.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wuapi.h
Library Wuguid.lib
Archivo DLL Wuapi.dll

Consulte también

IUpdateInstaller