Error Codes

These error codes are returned by the Windows Installer functions MsiExec.exe and InstMsi.exe. Note that any error in Winerror.h (such as ERROR_INVALID_DATA, included here) can be returned as well.

Note  The error codes ERROR_SUCCESS, ERROR_SUCCESS_REBOOT_INITIATED, and ERROR_SUCCESS_REBOOT_REQUIRED are indicative of success. If ERROR_SUCCESS_REBOOT_REQUIRED is returned, the installation completed successfully but a reboot is required to complete the installation operation.

See Windows Installer Error Messages for errors returned by the Windows Installer.

Note  If you are a user experiencing difficulty with your computer either during or after installing or uninstalling an application, you should contact customer support for the software you are trying to install or remove. If you feel you are in need of support for a Microsoft product, please go to our technical support site at support.microsoft.com.

Error codeValueDescription
ERROR_SUCCESS0The action completed successfully.
ERROR_INVALID_DATA13The data is invalid.
ERROR_INVALID_PARAMETER87One of the parameters was invalid.
ERROR_CALL_NOT_IMPLEMENTED120This value is returned when a custom action attempts to call a function that cannot be called from custom actions. The function returns the value ERROR_CALL_NOT_IMPLEMENTED. Available beginning with Windows Installer version 3.0.
ERROR_APPHELP_BLOCK1259If Windows Installer determines a product may be incompatible with the current operating system, it displays a dialog box informing the user and asking whether to try to install anyway. This error code is returned if the user chooses not to try the installation.
ERROR_INSTALL_SERVICE_FAILURE1601The Windows Installer service could not be accessed. Contact your support personnel to verify that the Windows Installer service is properly registered.
ERROR_INSTALL_USEREXIT1602The user cancels installation.
ERROR_INSTALL_FAILURE1603A fatal error occurred during installation.
ERROR_INSTALL_SUSPEND1604Installation suspended, incomplete.
ERROR_UNKNOWN_PRODUCT1605This action is only valid for products that are currently installed.
ERROR_UNKNOWN_FEATURE1606The feature identifier is not registered.
ERROR_UNKNOWN_COMPONENT1607The component identifier is not registered.
ERROR_UNKNOWN_PROPERTY1608This is an unknown property.
ERROR_INVALID_HANDLE_STATE1609The handle is in an invalid state.
ERROR_BAD_CONFIGURATION1610The configuration data for this product is corrupt. Contact your support personnel.
ERROR_INDEX_ABSENT1611The component qualifier not present.
ERROR_INSTALL_SOURCE_ABSENT1612The installation source for this product is not available. Verify that the source exists and that you can access it.
ERROR_INSTALL_PACKAGE_VERSION1613This installation package cannot be 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_UNINSTALLED1614The product is uninstalled.
ERROR_BAD_QUERY_SYNTAX1615The SQL query syntax is invalid or unsupported.
ERROR_INVALID_FIELD1616The record field does not exist.
ERROR_INSTALL_ALREADY_RUNNING1618Another installation is already in progress. Complete that installation before proceeding with this install.

For information about the mutex, see _MSIExecute Mutex.

ERROR_INSTALL_PACKAGE_OPEN_FAILED1619This installation package could not be opened. Verify that the package exists and is accessible, or contact the application vendor to verify that this is a valid Windows Installer package.
ERROR_INSTALL_PACKAGE_INVALID1620This installation package could not be opened. Contact the application vendor to verify that this is a valid Windows Installer package.
ERROR_INSTALL_UI_FAILURE1621There was an error starting the Windows Installer service user interface. Contact your support personnel.
ERROR_INSTALL_LOG_FAILURE1622There was an error opening installation log file. Verify that the specified log file location exists and is writable.
ERROR_INSTALL_LANGUAGE_UNSUPPORTED1623This language of this installation package is not supported by your system.
ERROR_INSTALL_TRANSFORM_FAILURE1624There was an error applying transforms. Verify that the specified transform paths are valid.
ERROR_INSTALL_PACKAGE_REJECTED1625This installation is forbidden by system policy. Contact your system administrator.
ERROR_FUNCTION_NOT_CALLED1626The function could not be executed.
ERROR_FUNCTION_FAILED1627The function failed during execution.
ERROR_INVALID_TABLE1628An invalid or unknown table was specified.
ERROR_DATATYPE_MISMATCH1629The data supplied is the wrong type.
ERROR_UNSUPPORTED_TYPE1630Data of this type is not supported.
ERROR_CREATE_FAILED1631The Windows Installer service failed to start. Contact your support personnel.
ERROR_INSTALL_TEMP_UNWRITABLE1632The Temp folder is either full or inaccessible. Verify that the Temp folder exists and that you can write to it.
ERROR_INSTALL_PLATFORM_UNSUPPORTED1633This installation package is not supported on this platform. Contact your application vendor.
ERROR_INSTALL_NOTUSED1634Component is not used on this machine.
ERROR_PATCH_PACKAGE_OPEN_FAILED1635This patch package could not be opened. Verify that the patch package exists and is accessible, or contact the application vendor to verify that this is a valid Windows Installer patch package.
ERROR_PATCH_PACKAGE_INVALID1636This patch package could not be opened. Contact the application vendor to verify that this is a valid Windows Installer patch package.
ERROR_PATCH_PACKAGE_UNSUPPORTED1637This patch package cannot be processed by the Windows Installer service. You must install a Windows service pack that contains a newer version of the Windows Installer service.
ERROR_PRODUCT_VERSION1638Another 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_LINE1639Invalid command line argument. Consult the Windows Installer SDK for detailed command-line help.
ERROR_INSTALL_REMOTE_DISALLOWED1640The current user is not permitted to perform installations from a client session of a server running the Terminal Server role service.
ERROR_SUCCESS_REBOOT_INITIATED1641The installer has initiated a restart. This message is indicative of a success.
ERROR_PATCH_TARGET_NOT_FOUND1642The installer cannot install the 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.
ERROR_PATCH_PACKAGE_REJECTED1643The patch package is not permitted by system policy.
ERROR_INSTALL_TRANSFORM_REJECTED1644One or more customizations are not permitted by system policy.
ERROR_INSTALL_REMOTE_PROHIBITED1645Windows Installer does not permit installation from a Remote Desktop Connection.
ERROR_PATCH_REMOVAL_UNSUPPORTED1646The patch package is not a removable patch package. Available beginning with Windows Installer version 3.0.
ERROR_UNKNOWN_PATCH1647The patch is not applied to this product. Available beginning with Windows Installer version 3.0.
ERROR_PATCH_NO_SEQUENCE1648No valid sequence could be found for the set of patches. Available beginning with Windows Installer version 3.0.
ERROR_PATCH_REMOVAL_DISALLOWED1649Patch removal was disallowed by policy. Available beginning with Windows Installer version 3.0.
ERROR_INVALID_PATCH_XML1650The XML patch data is invalid. Available beginning with Windows Installer version 3.0.
ERROR_PATCH_MANAGED_ADVERTISED_PRODUCT 1651Administrative user failed to apply patch for a per-user managed or a per-machine application that is in advertise state. Available beginning with Windows Installer version 3.0.
ERROR_INSTALL_SERVICE_SAFEBOOT 1652Windows Installer is not accessible when the computer is in Safe Mode. Exit Safe Mode and try again or try using System Restore to return your computer to a previous state. Available beginning with Windows Installer version 4.0.
ERROR_ROLLBACK_DISABLED 1653Could not perform a multiple-package transaction because rollback has been disabled. Multiple-Package Installations cannot run if rollback is disabled. Available beginning with Windows Installer version 4.5.
ERROR_SUCCESS_REBOOT_REQUIRED3010A restart is required to complete the install. This message is indicative of a success. This does not include installs where the ForceReboot action is run.

 

Send comments about this topic to Microsoft

Build date: 10/29/2009

Tags : error hresult msi


Community Content

Thomas Lee
Unknown error Code 4397

I have my computer set to check for updates in the middle of the night. I can't count the number of times the Microsoft Office Power Point Viewer failed to update. Daily it shows up as an important update, but always fails. How can I delete that update? I'm not a computer expert, just an ordinary user, so please keep reply simple. It's not an update I really need anyway. Help will be appreciated!



[tfl - 19 09 09] Hi - and thanks for your post. You should post questions like this to the MSDN Forums at http://forums.microsoft.com/msdn or the MSDN Newsgroups at

http://www.microsoft.com/communities/newsgroups/en-us/. You are much more likely get a quicker response using the forums than through the Community Content. For specific help about:
Visual Studio : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.vstudio%2C&
SQL Server : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.sqlserver%2C&
.NET Framework : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.dotnet.framework
PowerShell : http://groups.google.com/group/microsoft.public.windows.powershell/topics?pli=1
All Public : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public%2C&


Microsoft Installer error
Window Installer error
When I want to install a game it suddenly appears an error message which says"Installation end prematurely because of a fatal error".What is the error?
Tags :

Thomas Lee
unknown error

i have a error that i cant seem to find how to fix, and was wondering if anyone could help me out. whenever i try to install windows on my computer it cant select a drive to install it into, and whenever i press any button on this screen i get a blue-screen error and freeze. can anyone help me?


[tfl - 19 09 09] Hi - and thanks for your post. You should post questions like this to the MSDN Forums at http://forums.microsoft.com/msdn or the MSDN Newsgroups at

http://www.microsoft.com/communities/newsgroups/en-us/ . You are much more likely get a quicker response using the forums than through the Community Content. For specific help about:
Visual Studio :
http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.vstudio%2C &
SQL Server :
http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.sqlserver%2C &
.NET Framework :
http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.dotnet.framework
PowerShell : http://groups.google.com/group/microsoft.public.windows.powershell/topics?pli=1
All Public : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public%2C &


Thomas Lee
I am the service provider. Error 1601
I am trying to get my daughter's MS Office to work again. The original installation was done by the OEM. I have no discs but this is a registered machine and the software has been registered. When Word (2003) is opened I get the following.

Windows Installer
Preparing to install

An error occurred and this feature is no longer functioning properly. Would you like to repair this feature now?
Click Yes

Windows Installer
Preparing to install

Microsoft Office Word
Microsoft Office Word cannot install the necessary files due to Windows Error 1601

Microsoft Office Word
Microsoft Office Word has not been installed for the current user. Please run setup to install the application.

If I run setup the program will no doubt ask for the key. Since I don't have discs it will be impossible to provide the key. I don't know how to retrieve it from MS either. How can I fix this problem?

Windows XP
Dell Inspiron I6000
Microsoft Office 2003



[tfl - 19 09 09] Hi - and thanks for your post. You should post questions like this to the MSDN Forums at http://forums.microsoft.com/msdn or the MSDN Newsgroups at

http://www.microsoft.com/communities/newsgroups/en-us/. You are much more likely get a quicker response using the forums than through the Community Content. For specific help about:
Visual Studio :
http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.vstudio%2C&
SQL Server :
http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.sqlserver%2C&
.NET Framework :
http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.dotnet.framework
PowerShell : http://groups.google.com/group/microsoft.public.windows.powershell/topics?pli=1
All Public : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public%2C&


Page view tracker