Common Windows Installer (MSI) error codes
Condensed table of the most common Windows Installer return codes and their meaning.
Windows Installer returns a numeric code when an MSI installation, patch or removal fails or completes. The table below lists the most common codes, with descriptions reworded.
| Constant | Value | Meaning |
|---|---|---|
| ERROR_SUCCESS | 0 | The action completed successfully. |
| ERROR_INVALID_DATA | 13 | The data is invalid. |
| ERROR_INVALID_PARAMETER | 87 | One of the parameters is invalid. |
| ERROR_CALL_NOT_IMPLEMENTED | 120 | A custom action tried to call a function that cannot be used in that context. |
| ERROR_APPHELP_BLOCK | 1259 | Installation cancelled: the user chose not to install despite the compatibility warning. |
| ERROR_INSTALL_SERVICE_FAILURE | 1601 | The Windows Installer service cannot be accessed. |
| ERROR_INSTALL_USEREXIT | 1602 | Installation cancelled by the user. |
| ERROR_INSTALL_FAILURE | 1603 | A fatal error occurred during installation. |
| ERROR_INSTALL_SUSPEND | 1604 | Installation suspended, incomplete. |
| ERROR_UNKNOWN_PRODUCT | 1605 | The action is only valid for products that are currently installed. |
| ERROR_UNKNOWN_FEATURE | 1606 | The feature identifier is not registered. |
| ERROR_UNKNOWN_COMPONENT | 1607 | The component identifier is not registered. |
| ERROR_BAD_CONFIGURATION | 1610 | The configuration data for the product is corrupt. |
| ERROR_INSTALL_SOURCE_ABSENT | 1612 | The installation source for the product is not available. |
| ERROR_INSTALL_PACKAGE_VERSION | 1613 | This package cannot be installed by this version of Windows Installer; a newer version of the service is required. |
| ERROR_INSTALL_ALREADY_RUNNING | 1618 | Another installation is already in progress. |
| ERROR_INSTALL_PACKAGE_OPEN_FAILED | 1619 | The package cannot be opened; check that it exists and is accessible. |
| ERROR_INSTALL_PACKAGE_INVALID | 1620 | The package cannot be opened; it is probably not a valid Windows Installer package. |
| ERROR_INSTALL_LOG_FAILURE | 1622 | The log file cannot be opened; check that the location exists and is writable. |
| ERROR_INSTALL_TRANSFORM_FAILURE | 1624 | Transforms could not be applied; check the specified paths. |
| ERROR_INSTALL_PACKAGE_REJECTED | 1625 | Installation is forbidden by system policy. |
| ERROR_INSTALL_TEMP_UNWRITABLE | 1632 | The Temp folder is full or inaccessible. |
| ERROR_INSTALL_PLATFORM_UNSUPPORTED | 1633 | The package is not supported on this platform. |
| ERROR_PRODUCT_VERSION | 1638 | Another version of the product is already installed. |
| ERROR_INVALID_COMMAND_LINE | 1639 | Invalid command-line argument. |
| ERROR_INSTALL_REMOTE_DISALLOWED | 1640 | Installation is not allowed from a client session of a Terminal Server. |
| ERROR_SUCCESS_REBOOT_INITIATED | 1641 | The installer started a restart; this is a success. |
| ERROR_PATCH_TARGET_NOT_FOUND | 1642 | The patch cannot be applied: the program to upgrade is missing or the patch targets another version. |
| ERROR_PATCH_PACKAGE_REJECTED | 1643 | The patch is forbidden by system policy. |
| ERROR_INSTALL_TRANSFORM_REJECTED | 1644 | A customisation is forbidden by system policy. |
| ERROR_INSTALL_REMOTE_PROHIBITED | 1645 | Installation from a Remote Desktop session is not permitted. |
| ERROR_UNKNOWN_PATCH | 1647 | The patch is not applied to this product. |
| ERROR_PATCH_REMOVAL_DISALLOWED | 1649 | Patch removal is disallowed by policy. |
| ERROR_SUCCESS_REBOOT_REQUIRED | 3010 | A restart is required to complete the installation; this is a success. |
Notes
The table is condensed. The full list is in the Microsoft Learn documentation on Windows Installer error codes.