InstallExecuteSequence Table
The InstallExecuteSequence table lists actions that are executed when the top-level INSTALL action is executed.
Actions in the install sequence up to the InstallValidate action, and any 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 CostFinalize actions.
Custom actions requiring a user interface should use MsiProcessMessage instead of authored dialog boxes created using the Dialog table.
The InstallExecuteSequence 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 or a custom action.
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
-
Number that determines the sequence position in which this action is to be executed.
A positive value represents the sequence position. A Null value indicates that the action is not executed. The following negative values indicate that this action is to be 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
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