MsiSetInstallLevel function (msiquery.h)
The MsiSetInstallLevel function sets the installation level for a full product installation.
Syntax
UINT MsiSetInstallLevel(
[in] MSIHANDLE hInstall,
[in] int iInstallLevel
);
Parameters
[in] hInstall
Handle to the installation that is provided to a DLL custom action or obtained by using MsiOpenPackage, MsiOpenPackageEx, or MsiOpenProduct.
[in] iInstallLevel
The installation level.
Return value
The MsiSetInstallLevel function returns one of the following values:
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 (zero) or a negative number is passed in the iInstallLevel parameter, the current installation level does not change, but all features are still updated based on the current installation level. For more information, see Calling Database Functions From Programs.
If the function fails, you can obtain extended error information by using MsiGetLastErrorRecord.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP |
Target Platform | Windows |
Header | msiquery.h |
Library | Msi.lib |
DLL | Msi.dll |