Setup Error Handling
The Error Handling dialog box is one of the pages that appears when you click Advanced... on the Installer options page. It allows you to customize the installer's error handling behavior.
Dialog fields and options
The dialog contains a list of errors that you may select to treat as fatal errors during installation. If an error marked as fatal occurs during installation, the installation process is aborted and any changes made to the system are rolled back. If the error is not marked as fatal, the installer will continue with the remainder of the installation even if an error occurs. This may lead to an incomplete installation; it depends on your application if it can still function under those circumstances.
| Attribute | Description |
|---|---|
| File installation errors | Check this box to make file installation errors fatal; clear it to ignore them during installation. Note that delayed file installation (because of in-use files during installation) is not considered an error; delayed file operations are treated as a normal part of the installation sequence. |
| File registration errors | Check this box to make file registration errors fatal; clear it to ignore them during installation. File registration includes self-registration modes such as DllRegisterServer. |
| Shortcut creation errors | Check this box to make shortcut creation errors fatal; clear it to ignore them during installation. |
| Registry editing errors | Check this box to make registry operation errors fatal; clear it to ignore them during installation. Note that this includes not only the items on the Registry page, but also those on the File types and COM classes pages. On Windows NT-based platforms, installation and modification of environment variables also falls into this category. |
| INI file editing errors | Check this box to make INI file operation errors fatal; clear it to ignore them during installation. |
| Environment variable errors | Check this box to make environment variable errors fatal; clear it to ignore them during installation. On Windows NT-based systems, this is in addition to the Registry editing errors; you must clear both boxes to fully suppress environment variable errors on those systems. |
| Service installation errors | Check this box to make service installation errors fatal; clear it to ignore them during installation. |
| Service control errors | Check this box to make service control errors fatal; clear it to ignore them during installation. |
| Assembly registration errors | Check this box to make .Net and Windows side-by-side assembly registration and unregistration errors fatal; clear it to ignore them during installation. |
| Extension DLL failures | Check this box to make errors during extension DLL callbacks fatal; clear it to ignore them during installation. |
| Extension DLL FAIL requests | Check this box to make iTixRuntime::FailInstall requests fatal; clear it to ignore those requests. |
| External program run errors | Check this box to make errors while running external programs (as part of custom actions) fatal; clear it to ignore them during installation. This applies to Run Program, Run Script and Uninstall Product actions, but only if the Exit code option in those actions is set to something other than Ignore. |
| Uninstall action errors | Check this box to make errors during the uninstallation of other products fatal; clear it to ignore them during installation. |
| Installation package download errors | Check this box to make errors during the download of installation packages fatal; clear it to ignore them during installation. However, even if download errors are not treated as fatal, subsequent file installation will probably fail. |
| Cancellation by the user | Check this box to honor cancellation requests from the user during installation; clear it to continue installation even if the user chooses Cancel or presses Esc[ape]. The latter is considered to be bad form and should only be considered if you have an overriding need for it. |