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

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

Syntax

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 en el 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

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 COM o Windows.

códigos de error.

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 distribución (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 Updates de IUpdateInstaller . Este método también devuelve WU_E_NO_UPDATE si la propiedad Updates está establecida en una colección vacía.

Al usar cualquier API de WUA asincrónica 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 de WUA asincrónicas.

Requisitos

Consulte también

IUpdateInstaller