Custom Action Execution Scheduling Options

Windows Installer

Custom Action Execution Scheduling Options

Because a custom action can be scheduled in both the UI and execute sequence tables, and can be executed either in the service or client process, a custom action can potentially execute multiple times.

Note that the installer:

  • Executes actions in a sequence table immediately by default.
  • Does not execute an action if the conditional expression field of the sequence table evaluates to False.
  • Processes the UI sequence table in the client process if the internal user's interface level is set to the full UI mode (see MsiSetInternalUI for a description of UI levels).
  • Is a service registered by default when using Windows 2000 and, in this case, the execute sequence table is processed in the installer service.

You can use the following option flags to control multiple immediate execution of custom actions. To set an option, add the value in this table to the value in the Type field of the CustomAction table. None of the following flags should be used with deferred execution custom actions.

(default)

Hexadecimal: 0x00000000

Decimal: 0

Always execute. Action may run twice if present in both sequence tables.

msidbCustomActionTypeFirstSequence

Hexadecimal: 0x00000100

Decimal: 256

Execute no more than once if present in both sequence tables. Always skips action in execute sequence if UI sequence has run. No effect in UI sequence. The action is not required to be present or run in the UI sequence to be skipped in the execute sequence. Not affected by install service registration.

msidbCustomActionTypeOncePerProcess

Hexadecimal: 0x00000200

Decimal: 512

Execute once per process if in both sequence tables. Skips action in execute sequence if UI sequence has been run in same process, for example both run in the client process. Used to prevent actions that modify the session state, such as property and database data, from running twice.

msidbCustomActionTypeClientRepeat

Hexadecimal: 0x00000300

Decimal: 768

Execute only if running on client after UI sequence has run. The action runs only if the execute sequence is run on the client following UI sequence. May be used to provide either/or logic, or to suppress the UI-related processing if already done for the client session.

 

Note that to run a custom action during two different run modes, author two entries into the CustomAction table . For example, to have a custom action that calls a C/C++ dynamic link library (DLL) ( Custom Action Type 1) both when the mode is MSIRUNMODE_SCHEDULED and MSIRUNMODE_ROLLBACK, put two entries in the CustomAction table that call the same DLL but that have different numeric types. Include code that calls MsiGetMode to determine when to run which custom action.

See Also

Custom Action Reference
About Custom Actions
Using Custom Actions

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.