Manage Return Codes option in Patch My PC Publisher

Applies to: Patch My PC Publisher V3.x Available at level: Product Available on tab: WSUS Updates, ConfigMgr Apps, Intune Apps, Intune Updates

The Manage Return Codes right-click option in Patch My PC (PMPC) Publisher lets you control how installer exit codes are interpreted for a product in Publisher.

Each Return Code can be mapped to a specific code type to influence how the installation result is reported and how restart behavior is handled on the client.

This feature is commonly used to suppress reboot behavior or to ensure that non-standard success codes are correctly treated as successful installations.

Important

The management platform can also influence how devices respond to Return Codes, particularly regarding restart behavior.

Review the relevant Microsoft documentation for Intune, ConfigMgr, or WSUS to ensure Return Codes and restart actions behave as expected in your environment.

Return Code Mapping

Each Return Code returned by the installer is associated with a code type. The code type determines how Patch My PC ScriptRunner (which manages the installation) and the management platform interpret the result.

When you select the Manage Return Codes right-click option, the Manage Return Codes dialog appears, where you can manage Return Codes for the selected product.

The following Return Codes are commonly used by default:

Return Code	Code Type	Meaning
0	Success	Installation completed successfully
1707	Success	Product is already installed or no action was required
3010	SoftReboot	Installation succeeded and a reboot is recommended
1641	HardReboot	Installation succeeded and triggered an immediate reboot
1618	Retry	Another installation is in progress and the deployment should retry

Custom Return Codes

Some installers return non-standard exit codes, even when the installation succeeds. In these cases, you can add a custom Return Code and map it to Success.

For example, Brave Browser always exits with Return Code 19 on a successful installation.

As 19 is not treated as a success code by default, it can be mapped to Success so that the successful deployment is reported correctly.

To add a custom Return Code:

1. Locate the relevant product in the Product Tree.

2. Right-click it and select Manage Return Codes

3. On the Manage Return Codes dialog, click Add

1. In the Return Code field, enter the required Return Code (for example 19), and if the Code Type should be anything other than Success, select the relevant value from the Code Type dropdown beside the new Return Code.

1. Click OK to save your changes.

The Manage Return Codes dialog updates to show the new Return Code.