InstallUISequence Table

The InstallUISequence table lists actions that are executed when the top-level INSTALL action is executed and the internal user interface level is set to full UI or reduced UI. The installer skips the actions in this table if the user interface level is set to basic UI or no UI. See About the User Interface.

Actions in the install sequence up to the InstallValidate action, and the exit dialog boxes, are located in the InstallUISequence table. All actions from the InstallValidate through the end of the install sequence are in the InstallExecuteSequence table. Because the InstallExecuteSequence table needs to stand alone, it has any necessary initialization actions such as the LaunchConditions, CostInitialize, FileCost, and the CostFinalize, and ExecuteAction action.

The InstallUISequence table has the following columns.

Column Type Key Nullable
Action Identifier Y N
Condition Condition N Y
Sequence Integer N Y

 

Columns

Action

Name of the action to execute. This is either a built-in action, a custom action, or a user interface wizard.

Primary table key.

Condition

This field contains a conditional expression. If the expression evaluates to False, then the action is skipped. If the expression syntax is invalid, then the sequence terminates, returning iesBadActionData. For information on the syntax of conditional statements, see Conditional Statement Syntax.

Sequence

The number in this column determines the sequence position in which this action is run.

A positive value represents the sequence position. A Null value indicates that the action is never run. The following negative values indicate that this action is executed if the installer returns the associated termination flag. Each termination flag (negative value) can be used with no more than one action. Multiple actions can have termination flags, but they must be different flags. Termination flags (negative values) are typically used with Dialog Boxes.

Termination flag Value Description
msiDoActionStatusSuccess -1 Successful completion. Used with Exit dialog boxes.
msiDoActionStatusUserExit -2 User terminates install. Used with UserExit dialog boxes.
msiDoActionStatusFailure -3 Fatal exit terminates. Used with a FatalError dialog boxes.
msiDoActionStatusSuspend -4 Install is suspended.

 

Zero, all other negative numbers, or a Null value indicate that the action is never run.

Remarks

Associated localized text for progress display or logging is specified in the ActionText table.

For an example of a sequence table, see Using a Sequence Table.

Validation

ICE03
ICE06
ICE12
ICE13
ICE20
ICE26
ICE27
ICE28
ICE46
ICE75
ICE79
ICE82
ICE86