Custom Action Return Values

If the msidbCustomActionTypeContinue return processing option is not set, the custom action must return an integer status code as shown in the following table.

Return valueDescription
ERROR_SUCCESSCompleted actions successfully.
ERROR_INSTALL_USEREXITUser terminated prematurely.
ERROR_INSTALL_FAILUREUnrecoverable error occurred.
ERROR_NO_MORE_ITEMSSkip remaining actions, not an error.


Note that custom actions that are executable files must return a value of 0 for success. The installer interprets any other return value as failure. To ignore return values, set the msidbCustomActionTypeContinue bit flag in the Type field of the CustomAction table.

For more information about the msidbCustomActionTypeContinue option and other return processing options, see Custom Action Return Processing Options.

Note that Windows Installer translates the return values from all actions when it writes the return value into the log file. For example, if the action return value appears as 1 in the log file, this means that the action returned ERROR_SUCCESS. For more information about this translation see Logging of Action Return Values.

Related topics

Error Codes
Logging of Action Return Values