Additional Options Panel

InstallShield 2015 » Custom Action Wizard

The Additional Options panel lets you specify how the custom action thread should be processed and whether the custom action should be run only during patch uninstallation.

The Additional Options panel has the following settings.

Settings on the Additional Options Panel

Setting

Description

Return Processing

Specify how the custom action thread should be processed. Valid options for the Return Processing list are:

Asynchronous (No wait for completion)
Asynchronous (Wait for exit code)
Synchronous (Check exit code)
Synchronous (Ignores exit code)

These flags are used to specify that the main and custom action threads run synchronously (the installer waits for the custom action thread to complete before resuming the main installation thread) or asynchronously (the installer runs the custom action simultaneously as the main installation continues).

Note that some options are not applicable to some types of custom actions. Only options that pertain to the selected type of custom action are available in this list.

Run During Patch Uninstall

Project: If you are working on a project in Direct Edit mode, this setting is not applicable unless the database schema is a minimum of 405 (for Windows Installer 4.5 or later).

This check box lets you specify whether Windows Installer should run the custom action only when a patch is being uninstalled. You can select this check box for a custom action in an .msi package. You can also select this check box for a new custom action that is added by a patch. However, this check box should not be selected for a custom action that is being added or removed by a patch to an existing custom action. This check box is cleared by default.

When Windows Installer 4.5 runs the patch uninstall custom action, it uses the custom action in the patch that is being uninstalled.

Note: Windows Installer 4.5 includes support for this setting, but Windows Installer 4.0 and earlier do not. Therefore, if you select Yes for this setting and some target systems may have Windows Installer 4.0 or earlier, add a condition to this custom action to prevent Windows Installer 4.0 and earlier from running it. Otherwise, Windows Installer 4.0 and earlier would call the custom action during the installation, repair, or update of the package.

For the condition, use the MSIPATCHREMOVE property. For more information, see MSIPATCHREMOVE in the Windows Installer Help Library.

See Also