The SetInstallLevel method of the Session object sets the install level for the current installation to a specified value and recalculates the Select and Installed states for all features in the Feature table. It also sets the Action state of each component in the Component table based on the new level.

Syntax

Script
SetInstallLevel(
  installLevel
)

Parameters

installLevel

Required requested new install level.

Return Value

Remarks

The CostInitialize action must be executed prior to calling SetInstallLevel.

If 0 is passed for the installLevel parameter, the current install level is not changed, but all features are still updated based on the current install level. For example, this functionality could be used by the Handler module to reset all selections back to their initial default states at any point in the UI selection process.

If the method fails, you can obtain extended error information by using the LastErrorRecord method.

Requirements

See Also

Session

Send comments about this topic to Microsoft

Build date: 8/13/2009