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

Artículo
08/28/2023

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

Sintaxis

HRESULT BeginInstall(
  [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 la instalación antes de que se complete la instalación.

[in] onCompleted

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

[in] state

El estado específico del autor de la llamada devuelto por la propiedad AsyncState de la interfaz IInstallationJob .

[out] retval

Interfaz IInstallationJob que contiene las propiedades y los métodos que están disponibles para una operación de instalació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 instalación asincrónica de una actualización se inició correctamente.
WU_E_INSTALL_NOT_ALLOWED	No se puede llamar a este método cuando el instalador está instalando o quitando una actualización. Llame solo a este método 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.

Observaciones

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


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