Método IUpdateInstaller::BeginInstall (wuapi.h)
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 |
|---|---|
|
La instalación asincrónica de una actualización se inició correctamente. |
|
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. |
|
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 |