MsiSetInstallLevel

[This is preliminary documentation and subject to change.]

The MsiSetInstallLevel function sets the installation level for a full product installation.

UINT MsiSetInstallLevel(
  MSIHANDLE hInstall,   // installer handle
  int iInstallLevel     // install level
);
 

Parameters

hInstall

Handle to the installation.

iInstallLevel

Specifies the installation level.

Return Values

ERROR_FUNCTION_FAILED

The function failed.

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_SUCCESS

The function succeeded.

Remarks

The MsiSetInstallLevel function sets the following.

• The installation level for the current installation to a specified value.
• The Select and Installed states for all features in the Feature table.
• The Action state of each component in the Component table, based on the new level.

If 0 is passed in the ilnstallLevel parameter, the current installation level does not change, but all features are still updated based on the current installation level.

QuickInfo

  Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in msiquery.h.
  Import Library: Use msi.lib.

See Also

Database Access Reference, Installer Selection Functions