DeinstallStart

The DeinstallStart function is supported only for compatibility with scripts created in previous versions of InstallShield. We recommend that you use the MaintenanceStart function instead.

DeinstallStart enables uninstallation functionality by creating the following values under the application uninstallation registry key:

DeinstallStart Values
Value Name	Value Data
UninstallString	The value of the system variable UNINST. (Note that UNINST includes Setup.exe's -uninst option, which runs the setup as an uninstallation that prompts the user appropriately but does not execute any script code.)
DisplayName	The value of the system variable IFX_PRODUCT_NAME.
LogFile	<DISK1TARGET>\Setup.ilg
DisplayVersion	The value of the system variable IFX_PRODUCT_VERSION.
MajorVersion	The first byte of the data in the [Version] value.
MinorVersion	The second byte of the data in the [Version] value.
Version	The packed DWORD equivalent of the data in the [DisplayVersion] value.

DeinstallStart should be executed only once in a setup script. However, if you are launching multiple scripts using DoInstall, then you can in effect call DeinstallStart more than once in a setup because each individual script can call DeinstallStart once.

Syntax

Parameters

DeinstallStart Parameters
Parameter	Description
szObsolete	The value of this parameter is ignored.
svObsolete	You must pass a string variable in this parameter. No useful information is returned.
szObsolete	The value of this parameter is ignored.
lReserved	Pass zero in this parameter. No other value is allowed.

Return Values

DeinstallStart Return Values
Return Value	Description
0	Indicates that the function successfully created the registry key values.
< 0	Indicates that the function was unable to create one or more of the registry key values. You can obtain the error message text associated with a large negative return value—for example, -2147024891 (0x80070005)—by calling FormatMessage.

Additional Information

Calling DeinstallStart results in an uninstaller that runs without executing any script code.

The RegDBSetItem and RegDBGetItem functions set and retrieve the uninstallation icon name (the [DisplayName] value) under the application uninstallation key, which is created by calling the DeinstallStart function. Therefore, depending on the values to be set or retrieved, RegDBSetItem and RegDBGetItem require that DeinstallStart be called before they can be used.

Before calling any of the functions that use the SHAREDFILE or LOCKEDFILE option, and before calling SdFinishReboot, the application information key must be created using InstallationInfo, and the application uninstallation key must be created using the DeinstallStart function.

Enable(LOGGING) enables the logging of uninstallation information. It is enabled by default; you would need to call Enable only to reverse the effect of a previous call to Disable.