Session.EvaluateCondition method

The EvaluateCondition method of the Session object evaluates a logical expression that contains symbols and values. This method uses the MsiEvaluateCondition function.

Syntax

Session.EvaluateCondition(
  condition
)

Parameters

condition

Required string that contains the logical expression. For more information, see Conditional Statement Syntax.

Return value

This method returns an integer that indicates the evaluation of the condition.

Constant Value Description
msiEvaluateConditionFalse 0 The condition evaluates to false.
msiEvaluateConditionTrue 1 The condition evaluates to true.
msiEvaluateConditionNone 2 A conditional expression is not provided.
msiEvaluateConditionError 3 The condition contains a syntax error.

 

Remarks

Conditional expressions can be used to compare feature and component states. The following table shows the feature and component states that the EvaluateCondition method uses.

State Value Description
Null Null No action taken on feature or component.
msiInstallStateAbsent 2 Feature or component is not present.
msiInstallStateLocal 3 Feature or component is installed on the local computer.
msiInstallStateSource 4 Feature or component is installed to run from source.

 

Note

The states are not set until the SetInstallLevel method is called, either directly or by the CostFinalize Action. Therefore, state checking is only useful in conditional expression in an action sequence table.

 

Requirements

Requirement Value
Version
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
DLL
Msi.dll
IID
IID_ISession is defined as 000C109E-0000-0000-C000-000000000046

See also

Conditional Statement Syntax