List of error codes and error messages for Windows Installer processes

Summary

This article contains a list of the error codes and message text that may appear when the Microsoft Windows Installer (Msiexec.exe) performs an overall process.

Note Although the error code information in this article can help you diagnose your installation, a number of problems can cause a single error message. Thus, the information in this article is only the first step for troubleshooting the possible cause of the problem.

More Information

The following are some examples of Windows Installer processes:
  • Install the Windows Installer (Instmsi.exe on Microsoft Windows 98 and later, or Instmsiw.exe on Microsoft Windows NT 4.0 and Windows 2000).
  • Install Microsoft Visio 2002.
  • Apply a Windows Installer update (patch).
You can consider the error codes in the following table to be "Exit Codes" or "Return Codes". You can use these codes for error-level trapping in an MS-DOS batch file, or in Microsoft Systems Management Server (SMS) to find out the end result of the process.

Note You do not see the error code in the Windows Installer log file that Visio Setup creates unless you create a verbose log file.

Error code Value Description
---------------------------------------------------------------------------

ERROR_SUCCESS 0 Action completed successfully.

ERROR_INVALID_DATA 13 The data is invalid.

ERROR_INVALID_PARAMETER 87 One of the parameters was invalid.

ERROR_INSTALL_SERVICE_ 1601 The Windows Installer service could not be
FAILURE accessed. Contact your support personnel
to verify that the Windows Installer
service is properly registered.

ERROR_INSTALL_USEREXIT 1602 User cancel installation.

ERROR_INSTALL_FAILURE 1603 Fatal error during installation.

ERROR_INSTALL_SUSPEND 1604 Installation suspended, incomplete.

ERROR_UNKNOWN_PRODUCT 1605 This action is only valid for products that
are currently installed.

ERROR_UNKNOWN_FEATURE 1606 Feature ID not registered.

ERROR_UNKNOWN_COMPONENT 1607 Component ID not registered.

ERROR_UNKNOWN_PROPERTY 1608 Unknown property.

ERROR_INVALID_HANDLE_ 1609 Handle is in an invalid state.
STATE

ERROR_BAD_CONFIGURATION 1610 The configuration data for this product is
corrupted. Contact your support personnel.

ERROR_INDEX_ABSENT 1611 Component qualifier not present.

ERROR_INSTALL_SOURCE_ 1612 The installation source for this product
ABSENT is not available. Verify that the source
exists and that you can access it.

ERROR_INSTALL_PACKAGE_ 1613 This installation package cannot be
VERSION installed by the Windows Installer
service. You must install a Windows
service pack that contains a newer version
of the Windows Installer service.

ERROR_PRODUCT_ 1614 Product is uninstalled.
UNINSTALLED

ERROR_BAD_QUERY_SYNTAX 1615 SQL query syntax invalid or unsupported.

ERROR_INVALID_FIELD 1616 Record field does not exist.

ERROR_INSTALL_ALREADY_ 1618 Another installation is already in
RUNNING progress. Complete that installation
before proceeding with this install.

ERROR_INSTALL_PACKAGE_ 1619 This installation package could not be
OPEN_FAILED opened. Verify that the package exists and
that you can access it, or contact the
application vendor to verify that this is
a valid Windows Installer package.

ERROR_INSTALL_PACKAGE_ 1620 This installation package could not be
INVALID opened. Contact the application vendor to
verify that this is a valid Windows
Installer package.

ERROR_INSTALL_UI_ 1621 There was an error starting the Windows
FAILURE Installer service user interface. Contact
your support personnel.

ERROR_INSTALL_LOG_ 1622 Error opening installation log file.
FAILURE Verify that the specified log file
location exists and is writable.

ERROR_INSTALL_LANGUAGE_ 1623 This language of this installation package
UNSUPPORTED is not supported by your system.

ERROR_INSTALL_TRANSFORM_ 1624 Error applying transforms. Verify that
FAILURE the specified transform paths are valid.

ERROR_INSTALL_PACKAGE_ 1625 This installation is forbidden by system
REJECTED policy. Contact your system administrator.

ERROR_FUNCTION_NOT_ 1626 Function could not be executed.
CALLED

ERROR_FUNCTION_FAILED 1627 Function failed during execution.

ERROR_INVALID_TABLE 1628 Invalid or unknown table specified.

ERROR_DATATYPE_MISMATCH 1629 Data supplied is of wrong type.

ERROR_UNSUPPORTED_TYPE 1630 Data of this type is not supported.

ERROR_CREATE_FAILED 1631 The Windows Installer service failed to
start. Contact your support personnel.

ERROR_INSTALL_TEMP_ 1632 The temp folder is either full or
UNWRITABLE inaccessible. Verify that the temp folder
exists and that you can write to it.

ERROR_INSTALL_PLATFORM_ 1633 This installation package is not supported
UNSUPPORTED on this platform. Contact your application
vendor.

ERROR_INSTALL_NOTUSED 1634 Component not used on this computer.

ERROR_PATCH_PACKAGE_ 1635 This patch package could not be opened.
OPEN_FAILED Verify that the patch package exists and
that you can access it, or contact the
application vendor to verify that this is
a valid Windows Installer patch package.

ERROR_PATCH_PACKAGE_ 1636 This patch package could not be opened.
INVALID Contact the application vendor to verify
that this is a valid Windows Installer
patch package.

ERROR_PATCH_PACKAGE_ 1637 This patch package cannot be processed by
UNSUPPORTED the Windows Installer service. You must
install a Windows service pack that
contains a newer version of the Windows
Installer service.

ERROR_PRODUCT_VERSION 1638 Another version of this product is already
installed. Installation of this version
cannot continue. To configure or remove
the existing version of this product, use
Add/Remove Programs in Control Panel.

ERROR_INVALID_COMMAND_ 1639 Invalid command line argument. Consult the
LINE Windows Installer SDK for detailed command
line help.

ERROR_INSTALL_REMOTE_ 1640 Installation from a Terminal Server
DISALLOWED client session not permitted for
current user.

ERROR_SUCCESS_REBOOT_ 1641 The installer has started a reboot.
INITIATED This error code not available
on Windows Installer version 1.0.

ERROR_PATCH_TARGET_ 1642 The installer cannot install the
NOT_FOUND upgrade patch because the program
being upgraded may be missing, or the
upgrade patch updates a different
version of the program. Verify that
the program to be upgraded exists on
your computer and that you have the
correct upgrade patch.

This error code is not available on
Windows Installer version 1.0.

ERROR_SUCCESS_REBOOT_ 3010 A restart is required to complete the
REQUIRED install. This does not include installs
where the ForceReboot action is run. Note
that this error will not be available until
future version of the installer.

References

For more information about the Windows Installer, visit the following Microsoft Web site:
Properties

Article ID: 304888 - Last Review: Feb 8, 2007 - Revision: 1

Feedback