IUpdateInstaller::BeginUninstall method

Starts an asynchronous uninstallation of the updates.

Syntax

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

Parameters

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

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

• state [in]
  The caller-specific state that the AsyncState property IInstallationJob interface returns.

• retval [out]
  An IInstallationJob interface that contains the properties and methods that are available to an asynchronous uninstall 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