Add uninstall information to Add/Remove Programs - Revision history

Anders: /* How To Use */ Version hint

2023-09-17T00:37:59Z

How To Use: Version hint

â† Older revision		Revision as of 00:37, 17 September 2023
Line 4:		Line 4:
	Create a key with your product name under '''HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall''' to add entries to the "Add/Remove Programs" section in the Control Panel.		Create a key with your product name under '''HKLM\Software\Microsoft\Windows\CurrentVersion\Uninstall''' to add entries to the "Add/Remove Programs" section in the Control Panel.

	For Windows NT (NT4/2000/XP), it's also possible to create the key in the '''HKCU''' hive, so it will only appear for the current user.		For Windows NT (NT4/2000/XP/Vista and higher), it's also possible to create the key in the '''HKCU''' hive, so it will only appear for the current user.

	There are several values you can write to the key to give additional information about your application and the uninstaller.		There are several values you can write to the key to give additional information about your application and the uninstaller.

Anders: /* Optional values */ Link to MSDN

2022-02-17T02:11:19Z

Optional values: Link to MSDN

â† Older revision		Revision as of 02:11, 17 February 2022
Line 92:		Line 92:
	'''Supported on:''' ''Windows XP Service Pack 2''.		'''Supported on:''' ''Windows XP Service Pack 2''.

	*''ParentKeyName'' (string) - If the program is an update of a parent program, specify the parent program subkey name. If "OperatingSystem", it's an update for Windows.		*[https://docs.microsoft.com/en-us/windows/win32/shell/cpl-setprogramaccess#filtering-the-add-or-remove-programs-list ''ParentKeyName''] (string) - If the program is an update of a parent program, specify the parent program subkey name. If "OperatingSystem", it's an update for Windows.
	*''ParentDisplayName'' (string) - If the program is an update of a parent program, specify the parent program name (as specified on the parent's "DisplayName").		*''ParentDisplayName'' (string) - If the program is an update of a parent program, specify the parent program name (as specified on the parent's "DisplayName").

Anders: /* Optional values */ Added Language entry

2021-02-15T13:40:42Z

Optional values: Added Language entry

â† Older revision		Revision as of 13:40, 15 February 2021
Line 61:		Line 61:
	*''ModifyPath'' (string) - Path and filename of the application modify program		*''ModifyPath'' (string) - Path and filename of the application modify program
	*''InstallSource'' (string) - Location where the application was installed from		*''InstallSource'' (string) - Location where the application was installed from
			*''Language'' (DWORD) - $Language

	*''ProductID'' (string) - Product ID of the application		*''ProductID'' (string) - Product ID of the application

Anders: /* Optional values */ Real world vs documented required values

2018-06-01T20:20:14Z

Optional values: Real world vs documented required values

â† Older revision		Revision as of 20:20, 1 June 2018
Line 49:		Line 49:
	== Optional values ==		== Optional values ==

	See [http://windowssucks.wordpress.com/win-registry-uninstall-values/ here] for a more detailed description and hints. InstallLocation, Publisher and "ProductVersion" are required to pass [https://msdn.microsoft.com/en-us/library/windows/desktop/mt637085#cleanReversibleInstall <abbr title="Windows App Certification Kit">WACK</abbr>].		See [http://windowssucks.wordpress.com/win-registry-uninstall-values/ here] for a more detailed description and hints. InstallLocation, Publisher and "ProductVersion" are documented as required to pass [https://msdn.microsoft.com/en-us/library/windows/desktop/mt637085#cleanReversibleInstall <abbr title="Windows App Certification Kit">WACK</abbr>] but InstallLocation does seem to be optional when testing. "ProductVersion" means VersionMajor+VersionMinor and/or DisplayVersion.

	'''Supported on:''' ''Windows XP'', but note that it is perfectly allowed to add these entries to older versions of windows also, the additional info just does not show up.		'''Supported on:''' ''Windows XP'', but note that it is perfectly allowed to add these entries to older versions of windows also, the additional info just does not show up.

Anders: /* Optional values */ Linked to relevant WACK page

2018-06-01T19:56:00Z

Optional values: Linked to relevant WACK page

â† Older revision		Revision as of 19:56, 1 June 2018
Line 49:		Line 49:
	== Optional values ==		== Optional values ==

	See [http://windowssucks.wordpress.com/win-registry-uninstall-values/ here] for a more detailed description and hints. InstallLocation, Publisher, and ProductVersion are required to pass <abbr title="Windows App Certification Kit">WACK</abbr>.		See [http://windowssucks.wordpress.com/win-registry-uninstall-values/ here] for a more detailed description and hints. InstallLocation, Publisher and "ProductVersion" are required to pass [https://msdn.microsoft.com/en-us/library/windows/desktop/mt637085#cleanReversibleInstall <abbr title="Windows App Certification Kit">WACK</abbr>].

	'''Supported on:''' ''Windows XP'', but note that it is perfectly allowed to add these entries to older versions of windows also, the additional info just does not show up.		'''Supported on:''' ''Windows XP'', but note that it is perfectly allowed to add these entries to older versions of windows also, the additional info just does not show up.

Anders: /* Optional values */ Added WACK note.

2018-06-01T18:30:31Z

Optional values: Added WACK note.

â† Older revision		Revision as of 18:30, 1 June 2018
Line 49:		Line 49:
	== Optional values ==		== Optional values ==

	See [http://windowssucks.wordpress.com/win-registry-uninstall-values/ here] for a more detailed description and hints.		See [http://windowssucks.wordpress.com/win-registry-uninstall-values/ here] for a more detailed description and hints. InstallLocation, Publisher, and ProductVersion are required to pass <abbr title="Windows App Certification Kit">WACK</abbr>.

	'''Supported on:''' ''Windows XP'', but note that it is perfectly allowed to add these entries to older versions of windows also, the additional info just does not show up.		'''Supported on:''' ''Windows XP'', but note that it is perfectly allowed to add these entries to older versions of windows also, the additional info just does not show up.

Anders: /* Optional values */ Added InstallDate

2018-05-31T14:22:37Z

Optional values: Added InstallDate

â† Older revision		Revision as of 14:22, 31 May 2018
Line 54:		Line 54:

	*''InstallLocation'' (string) - Installation directory ($INSTDIR)		*''InstallLocation'' (string) - Installation directory ($INSTDIR)
			*''InstallDate'' (string) - Install date in yyyyMMdd format. [https://blogs.msdn.microsoft.com/oldnewthing/20180522-00/?p=98805 Windows uses the keys modified date] if not present.
	*''DisplayIcon'' (string) - Path, filename and index of of the icon that will be displayed next to your application name		*''DisplayIcon'' (string) - Path, filename and index of of the icon that will be displayed next to your application name

Kichik: Reverted edits by Ipodsoft to last version by 82.47.175.180

2013-03-30T03:46:14Z

Reverted edits by Ipodsoft to last version by 82.47.175.180

â† Older revision		Revision as of 03:46, 30 March 2013
Line 1:		Line 1:
	{{PageAuthor\|Konrad}}		{{PageAuthor\|Konrad}}

	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~

	== How To Use ==		== How To Use ==
Line 11:		Line 9:

	Write a value using the WriteRegStr command (for strings) or WriteRegDWORD command (for DWORD values).		Write a value using the WriteRegStr command (for strings) or WriteRegDWORD command (for DWORD values).


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	Example:		Example:
Line 22:		Line 16:
	"DisplayName" "Application Name"		"DisplayName" "Application Name"
	</highlight-nsis>		</highlight-nsis>


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	== Required values ==		== Required values ==
Line 33:		Line 23:

	Consider this example. Your company is called 'Great Northern Software Co' and you are installing their latest super software 'Image Maker'. What you want to do is to have a new key created in the Software\Microsoft\Windows\CurrentVersion\Uninstall section of HKLM. The key will be the name of the software, and it will have two subkeys, one with the display name of the software and the other the location of the uninstall program.		Consider this example. Your company is called 'Great Northern Software Co' and you are installing their latest super software 'Image Maker'. What you want to do is to have a new key created in the Software\Microsoft\Windows\CurrentVersion\Uninstall section of HKLM. The key will be the name of the software, and it will have two subkeys, one with the display name of the software and the other the location of the uninstall program.


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	<highlight-nsis>		<highlight-nsis>
Line 48:		Line 34:

	Two things to point out. First, you must use backslashes. I do a lot of Java/Unix work, so I need to make this clear. And second, you should add a delete key command to your uninstaller section, so the name will be removed from the list when your uninstaller completes. If you don't do this your name will still be there, but windows will see this as a problem (ie it will say the entry is corrupt).		Two things to point out. First, you must use backslashes. I do a lot of Java/Unix work, so I need to make this clear. And second, you should add a delete key command to your uninstaller section, so the name will be removed from the list when your uninstaller completes. If you don't do this your name will still be there, but windows will see this as a problem (ie it will say the entry is corrupt).


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	<highlight-nsis>		<highlight-nsis>
	DeleteRegKey HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\ImageMaker"		DeleteRegKey HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\ImageMaker"
	</highlight-nsis>		</highlight-nsis>


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	== Recommended values ==		== Recommended values ==
	*''QuietUninstallString'' (string) - Path and filename of the uninstaller and also a switch that uninstalls without a visible window. Most corporations need to install and uninstall silently. This ability should be included whenever possible. Similar to UninstallString, you should '''always''' quote the path to make sure spaces in the path will not disrupt Windows to find the uninstaller.		*''QuietUninstallString'' (string) - Path and filename of the uninstaller and also a switch that uninstalls without a visible window. Most corporations need to install and uninstall silently. This ability should be included whenever possible. Similar to UninstallString, you should '''always''' quote the path to make sure spaces in the path will not disrupt Windows to find the uninstaller.


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	<highlight-nsis>		<highlight-nsis>
Line 72:		Line 46:
	"QuietUninstallString" "$\"$INSTDIR\uninstall.exe$\" /S"		"QuietUninstallString" "$\"$INSTDIR\uninstall.exe$\" /S"
	</highlight-nsis>		</highlight-nsis>


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	== Optional values ==		== Optional values ==
Line 122:		Line 92:
	*''ParentKeyName'' (string) - If the program is an update of a parent program, specify the parent program subkey name. If "OperatingSystem", it's an update for Windows.		*''ParentKeyName'' (string) - If the program is an update of a parent program, specify the parent program subkey name. If "OperatingSystem", it's an update for Windows.
	*''ParentDisplayName'' (string) - If the program is an update of a parent program, specify the parent program name (as specified on the parent's "DisplayName").		*''ParentDisplayName'' (string) - If the program is an update of a parent program, specify the parent program name (as specified on the parent's "DisplayName").


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	== Computing EstimatedSize ==		== Computing EstimatedSize ==
Line 133:		Line 99:
	'''Method 1:''' Use ${GetSize} to fill in the EstimatedSize value.		'''Method 1:''' Use ${GetSize} to fill in the EstimatedSize value.
	This assumes the simple case where there is one main directory with most of your files (including subdirs):		This assumes the simple case where there is one main directory with most of your files (including subdirs):


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	<highlight-nsis>		<highlight-nsis>
Line 152:		Line 114:
	SectionEnd		SectionEnd
	</highlight-nsis>		</highlight-nsis>


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	'''Method 2:''' Compute the sum of all components installed sizes. This method is much faster, especialy for a large program, but it requires correct size info stored in the section itself. For example, if the section generates large data files in the install directory, and these files are not included via ''File'' but generated at installer runtime, then you need to account for the extra space using ''AddSize''		'''Method 2:''' Compute the sum of all components installed sizes. This method is much faster, especialy for a large program, but it requires correct size info stored in the section itself. For example, if the section generates large data files in the install directory, and these files are not included via ''File'' but generated at installer runtime, then you need to account for the extra space using ''AddSize''


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	<highlight-nsis>		<highlight-nsis>
Line 192:		Line 146:
	FunctionEnd		FunctionEnd
	</highlight-nsis>		</highlight-nsis>


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	== With a MultiUser Installer ==		== With a MultiUser Installer ==
Line 229:		Line 179:
	SectionEnd		SectionEnd
	</highlight-nsis>		</highlight-nsis>


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	Key points (see also [http://forums.winamp.com/showthread.php?t=289071 this forum thread]):		Key points (see also [http://forums.winamp.com/showthread.php?t=289071 this forum thread]):
	* use SHCTX (SHELL_CONTEXT) instead of HKLM; SHCTX will be either HKLM (when installing for all users) or HKCU (when installing for the current user)		* use SHCTX (SHELL_CONTEXT) instead of HKLM; SHCTX will be either HKLM (when installing for all users) or HKCU (when installing for the current user)
	* the $MultiUser.InstallMode variable is either AllUsers or CurrentUser; passing it as part of the uninstall string lets the uninstaller know whether it should remove the uninstall key from HKLM or HKCU; in order to make this work, you have to define MULTIUSER_INSTALLMODE_COMMANDLINE		* the $MultiUser.InstallMode variable is either AllUsers or CurrentUser; passing it as part of the uninstall string lets the uninstaller know whether it should remove the uninstall key from HKLM or HKCU; in order to make this work, you have to define MULTIUSER_INSTALLMODE_COMMANDLINE


	~~'''Source(s):''' [http://www.downloadranking.com Programs solutions]~~


	[[Category:Tutorials]]		[[Category:Tutorials]]

Ipodsoft at 02:10, 30 March 2013

2013-03-30T02:10:36Z

â† Older revision		Revision as of 02:10, 30 March 2013
Line 1:		Line 1:
	{{PageAuthor\|Konrad}}		{{PageAuthor\|Konrad}}

			'''Source(s):''' [http://www.downloadranking.com Programs solutions]

	== How To Use ==		== How To Use ==
Line 9:		Line 11:

	Write a value using the WriteRegStr command (for strings) or WriteRegDWORD command (for DWORD values).		Write a value using the WriteRegStr command (for strings) or WriteRegDWORD command (for DWORD values).


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	Example:		Example:
Line 16:		Line 22:
	"DisplayName" "Application Name"		"DisplayName" "Application Name"
	</highlight-nsis>		</highlight-nsis>


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	== Required values ==		== Required values ==
Line 23:		Line 33:

	Consider this example. Your company is called 'Great Northern Software Co' and you are installing their latest super software 'Image Maker'. What you want to do is to have a new key created in the Software\Microsoft\Windows\CurrentVersion\Uninstall section of HKLM. The key will be the name of the software, and it will have two subkeys, one with the display name of the software and the other the location of the uninstall program.		Consider this example. Your company is called 'Great Northern Software Co' and you are installing their latest super software 'Image Maker'. What you want to do is to have a new key created in the Software\Microsoft\Windows\CurrentVersion\Uninstall section of HKLM. The key will be the name of the software, and it will have two subkeys, one with the display name of the software and the other the location of the uninstall program.


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	<highlight-nsis>		<highlight-nsis>
Line 34:		Line 48:

	Two things to point out. First, you must use backslashes. I do a lot of Java/Unix work, so I need to make this clear. And second, you should add a delete key command to your uninstaller section, so the name will be removed from the list when your uninstaller completes. If you don't do this your name will still be there, but windows will see this as a problem (ie it will say the entry is corrupt).		Two things to point out. First, you must use backslashes. I do a lot of Java/Unix work, so I need to make this clear. And second, you should add a delete key command to your uninstaller section, so the name will be removed from the list when your uninstaller completes. If you don't do this your name will still be there, but windows will see this as a problem (ie it will say the entry is corrupt).


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	<highlight-nsis>		<highlight-nsis>
	DeleteRegKey HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\ImageMaker"		DeleteRegKey HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\ImageMaker"
	</highlight-nsis>		</highlight-nsis>


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	== Recommended values ==		== Recommended values ==
	*''QuietUninstallString'' (string) - Path and filename of the uninstaller and also a switch that uninstalls without a visible window. Most corporations need to install and uninstall silently. This ability should be included whenever possible. Similar to UninstallString, you should '''always''' quote the path to make sure spaces in the path will not disrupt Windows to find the uninstaller.		*''QuietUninstallString'' (string) - Path and filename of the uninstaller and also a switch that uninstalls without a visible window. Most corporations need to install and uninstall silently. This ability should be included whenever possible. Similar to UninstallString, you should '''always''' quote the path to make sure spaces in the path will not disrupt Windows to find the uninstaller.


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	<highlight-nsis>		<highlight-nsis>
Line 46:		Line 72:
	"QuietUninstallString" "$\"$INSTDIR\uninstall.exe$\" /S"		"QuietUninstallString" "$\"$INSTDIR\uninstall.exe$\" /S"
	</highlight-nsis>		</highlight-nsis>


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	== Optional values ==		== Optional values ==
Line 92:		Line 122:
	*''ParentKeyName'' (string) - If the program is an update of a parent program, specify the parent program subkey name. If "OperatingSystem", it's an update for Windows.		*''ParentKeyName'' (string) - If the program is an update of a parent program, specify the parent program subkey name. If "OperatingSystem", it's an update for Windows.
	*''ParentDisplayName'' (string) - If the program is an update of a parent program, specify the parent program name (as specified on the parent's "DisplayName").		*''ParentDisplayName'' (string) - If the program is an update of a parent program, specify the parent program name (as specified on the parent's "DisplayName").


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	== Computing EstimatedSize ==		== Computing EstimatedSize ==
Line 99:		Line 133:
	'''Method 1:''' Use ${GetSize} to fill in the EstimatedSize value.		'''Method 1:''' Use ${GetSize} to fill in the EstimatedSize value.
	This assumes the simple case where there is one main directory with most of your files (including subdirs):		This assumes the simple case where there is one main directory with most of your files (including subdirs):


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	<highlight-nsis>		<highlight-nsis>
Line 114:		Line 152:
	SectionEnd		SectionEnd
	</highlight-nsis>		</highlight-nsis>


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	'''Method 2:''' Compute the sum of all components installed sizes. This method is much faster, especialy for a large program, but it requires correct size info stored in the section itself. For example, if the section generates large data files in the install directory, and these files are not included via ''File'' but generated at installer runtime, then you need to account for the extra space using ''AddSize''		'''Method 2:''' Compute the sum of all components installed sizes. This method is much faster, especialy for a large program, but it requires correct size info stored in the section itself. For example, if the section generates large data files in the install directory, and these files are not included via ''File'' but generated at installer runtime, then you need to account for the extra space using ''AddSize''


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	<highlight-nsis>		<highlight-nsis>
Line 146:		Line 192:
	FunctionEnd		FunctionEnd
	</highlight-nsis>		</highlight-nsis>


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	== With a MultiUser Installer ==		== With a MultiUser Installer ==
Line 179:		Line 229:
	SectionEnd		SectionEnd
	</highlight-nsis>		</highlight-nsis>


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	Key points (see also [http://forums.winamp.com/showthread.php?t=289071 this forum thread]):		Key points (see also [http://forums.winamp.com/showthread.php?t=289071 this forum thread]):
	* use SHCTX (SHELL_CONTEXT) instead of HKLM; SHCTX will be either HKLM (when installing for all users) or HKCU (when installing for the current user)		* use SHCTX (SHELL_CONTEXT) instead of HKLM; SHCTX will be either HKLM (when installing for all users) or HKCU (when installing for the current user)
	* the $MultiUser.InstallMode variable is either AllUsers or CurrentUser; passing it as part of the uninstall string lets the uninstaller know whether it should remove the uninstall key from HKLM or HKCU; in order to make this work, you have to define MULTIUSER_INSTALLMODE_COMMANDLINE		* the $MultiUser.InstallMode variable is either AllUsers or CurrentUser; passing it as part of the uninstall string lets the uninstaller know whether it should remove the uninstall key from HKLM or HKCU; in order to make this work, you have to define MULTIUSER_INSTALLMODE_COMMANDLINE


			'''Source(s):''' [http://www.downloadranking.com Programs solutions]


	[[Category:Tutorials]]		[[Category:Tutorials]]

82.47.175.180: /* Optional values */

2012-10-10T10:55:28Z

Optional values

â† Older revision		Revision as of 10:55, 10 October 2012
Line 48:		Line 48:

	== Optional values ==		== Optional values ==

			See [http://windowssucks.wordpress.com/win-registry-uninstall-values/ here] for a more detailed description and hints.

	'''Supported on:''' ''Windows XP'', but note that it is perfectly allowed to add these entries to older versions of windows also, the additional info just does not show up.		'''Supported on:''' ''Windows XP'', but note that it is perfectly allowed to add these entries to older versions of windows also, the additional info just does not show up.
Line 90:		Line 92:
	*''ParentKeyName'' (string) - If the program is an update of a parent program, specify the parent program subkey name. If "OperatingSystem", it's an update for Windows.		*''ParentKeyName'' (string) - If the program is an update of a parent program, specify the parent program subkey name. If "OperatingSystem", it's an update for Windows.
	*''ParentDisplayName'' (string) - If the program is an update of a parent program, specify the parent program name (as specified on the parent's "DisplayName").		*''ParentDisplayName'' (string) - If the program is an update of a parent program, specify the parent program name (as specified on the parent's "DisplayName").

	~~Also see [http://windowssucks.wordpress.com/win-registry-uninstall-values/ here] for more details and a few interesting notes.~~

	== Computing EstimatedSize ==		== Computing EstimatedSize ==