IUpdateInstaller::BeginInstall method

Starts an asynchronous installation of the updates.

Syntax

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

Parameters

• onProgressChanged [in]
  An IInstallationProgressChangedCallback interface that is called periodically for installation progress changes before the installation is complete.

• onCompleted [in]
  An IInstallationCompletedCallback interface that is called when an installation operation is complete.

• state [in]
  The caller-specific state that is returned by the AsyncState property of the IInstallationJob interface.

• retval [out]
  An IInstallationJob interface that contains the properties and methods that are available to an asynchronous installation operation that was initiated.

Return value

This method returns the following HRESULT values and other COM or Windows error codes.

Remarks

If you call this method from a scripting language, set the onProgressChanged parameter to the identifier of an Automation object with a dispatch identifier (DSIPID) of zero (0) that implements the callback routine. Do the same thing for the onCompleted parameter.

This method returns WU_E_NO_UPDATE if the Updates property of IUpdateInstaller is not set. This method also returns WU_E_NO_UPDATE if the Updates property is set to an empty collection.

When you use any asynchronous WUA API in your app, you might need to implement a time-out mechanism. For more info about how to perform asynchronous WUA operations, see Guidelines for Asynchronous WUA Operations.

Requirements

See also

IUpdateInstaller