Troubleshooting Microsoft Installer Errors

<< Click to Display Table of Contents >>

Troubleshooting Microsoft Installer Errors

The Microsoft Installer (.msi) generates return codes (AKA error codes) when a .msi file completes. There are three (3) return codes that are automatically marked as a Success (e.g. these have an entry in the Success Codes field of the respective PDQ Deploy package step):

MSI Return Code



This is (almost always) considered successful and should be treated as such except in very rare cases.


This return code means that the installation required the target to reboot AND that a reboot was initiated.


This return code means the installation requires a reboot but a reboot was NOT initiated. (See image below.)

Note: For information on configuring success codes in Command step properties, see Command Step Properties.

We recommend using the Command Step to uninstall an application that was installed via MSI. In these Uninstall cases it is common to add the code 1605 to the Return Codes field. Note, this is NOT done by default (see image below).

For a comprehensive list of Windows system error codes, see

The following are some Microsoft Articles which describe different Microsoft Installer error codes:




© 2024 Corporation. All rights reserved. is a trademark of Corporation. All other product and company names are the property of their respective owners.

Help Version: 19.3.553.0