Share via


IUpdateInstaller::IsForced property

Gets or sets a Boolean value that indicates whether to forcibly install or uninstall an update.

This property is read/write.

Syntax

HRESULT put_IsForced(
  [in]  VARIANT_BOOL value
);

HRESULT get_IsForced(
  [out] VARIANT_BOOL *retval
);

Property value

VARIANT_TRUE if an update must be forcibly installed or uninstalled; otherwise, VARIANT_FALSE.

Error codes

Returns S_OK if successful. Otherwise, returns a COM or Windows error code.

Remarks

A forced installation is an installation in which an update is installed even if the metadata indicates that the update is already installed. A forced uninstallation is an uninstallation in which an update is removed even if the metadata indicates that the update is not installed.

Before you use IsForced to force an installation, determine whether the update is installed and available. If an update is not installed, a forced installation fails. For example, an update can be downloaded, and then its corresponding files removed from the cache after the expiration limit. In this case, if the files are not installed, a forced installation of the update fails.

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional with SP3 [desktop apps only]

Minimum supported server

Windows Server 2003, Windows 2000 Server with SP3 [desktop apps only]

Header

Wuapi.h

IDL

Wuapi.idl

Library

Wuguid.lib

DLL

Wuapi.dll

See also

IUpdateInstaller