[펌]msi installer custom action return value

IT/주워담기 2010. 10. 21. 09:46 Posted by Imtraveller
반응형

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 value Description
ERROR_FUNCTION_NOT_CALLED Action not executed.
ERROR_SUCCESS Completed actions successfully.
ERROR_INSTALL_USEREXIT User terminated prematurely.
ERROR_INSTALL_FAILURE Unrecoverable error occurred.
ERROR_NO_MORE_ITEMS Skip 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.

Logging of Action Return Values

The Installer writes the following values into the log when an action returns these error codes. For the entire list of error codes returned by the Windows Installer function calls MsiExec.exe, and InstMsi.exe, see Error Codes.

Error Code Values returned by function calls MsiExec.exe, and InstMsi.exe Values that appear in the Log. Description
ERROR_FUNCTION_NOT_CALLED 1626 0 A function could not be executed.
ERROR_SUCCESS 0 1 An action completed successfully.
ERROR_INSTALL_USEREXIT 1602 2 A user canceled installation.
ERROR_INSTALL_FAILURE 1603 3 A fatal error.
ERROR_INSTALL_SUSPEND 1604 4 The installation suspended, incomplete.
ERROR_SUCCESS 0 5 The action completed successfully.
ERROR_INVALID_HANDLE_STATE 1609 6 The handle is in an invalid state.
ERROR_INVALID_DATA 1626 7 The data is invalid.
ERROR_INSTALL_ALREADY_RUNNING 1618 8 Another installation is in progress. Only one installation at a time can run actions in the InstallExecuteSequence, AdminExecuteSequence, or AdvtExecuteSequence tables.

 


반응형