Property Name | Data Type | Description |
|---|---|---|
Command | ucComs | The uninstall command that should be performed. There is a defined set of commands from which you you can choose in the list box. Please see below for information. |
Parameters | String | Depending on the selected command, you must provide parameters like filenames, folder names... |
Here is the description of available uninstall commands:
Command Name | Parameters | Description |
ucDelFile | Filename | The Uninstaller will remove the filename specified by Filename. |
ucDelFolder | Folder Name | Removes the folder (only empty directories are supported) specified by the parameters. |
| ucDelWildFiles | Path name + source wildcard | Removes all files matching the wildcard in the folder specified by the path name. For instance %DESTPATH%\Parameters\*.* |
| ucDonotRemove | "Command name","Param1",...,"ParamN" | This command is similar to an "anti-command". It removes an existing entry from the log file; for example, extracted files are automatically referenced in the log by the package. If you do not want a file to be uninstalled, then you can use this command. See examples below. |
| ucRemoveFromIni | "ENT","IniFile","AppName","Key" | Removes the specified key from the .ini. See below for examples. Note that ENT is used internally: do not change this entry. |
| ucRemoveRegKey | "KEY","[key number]","[full key name]","[full]" | Causes the uninstaller to remove a registry key including all items optionally. See details below. |
ucRunBat | Batch Filename (.BAT) | Executes (and waits for end) the Batch file specified by the parameters silently. |
| ucRunFile | Filename | The Uninstaller will run the specified file: it can be a document file or an executable file. If this is an executable file (.EXE extension), then the uninstaller will run it and wait upon the end of its execution. |
| ucShowMsg | Message to be displayed | This will cause the uninstaller to display a message box. |
Tip: The command ucRunFile is useful for example if you would like to unregister ActiveX controls manually, launch additional cleaning utilities.
Important: note that ActiveX (.OCX) and DLL files which were registered using the "Self-register a file" custom action are automatically unregistered by the uninstaller if necessary. Have a look at the help topic of this "Self-register a file" custom action.
Example for ucRunFile:
For example, if you want to unregister an ActiveX control manually, use the REGSVR32.exe program shipped with Windows (ensure it is available on the system). Add an "ucRunFile" uninstall command and enter this line as Parameters:
"REGSVR32.exe"," /s/u "%SYS%\PBShEx.dll"" (including all quotes).
This will cause the uninstaller to run REGSVR32.exe with the command line << /s/u "%SYS%\PBShEx.dll" >>, that causes the PBShEx.dll previously-registered DLL file to be unregistered silently. For an ActiveX control, just replace PBShEx.dll by Mycontrol.OCX.
Details and examples about ucRemoveRegKey:
The "Parameters" value should be formatted like this: "KEY","[key number]","[full key name]","[full]". Only replace the [ ] brackets by the corresponding values.
[key number] indicates the root key; it is an integer number indexing the key.
0 hkClassesRoot 1 hkCurrentConfig 2 hkCurrentUser 3 hkDynData 4 hkLocalMachine 5 hkUsers [full key name] is the name of the key such as SOFTWARE\My company\My application
[full] is a boolean value (0 or 1). If set to "1", it tells the uninstaller that the key including all of its entries should be removed. If set to "0", the key will be removed only it is blank (no more entry or subkey).
Note: under Windows 95, if the key has subkeys, the subkeys and any associated data are also removed. Under Windows NT, subkeys must be explicitly deleted by separate calls to ucRemoveRegKey.
Examples:
"KEY","2","SOFTWARE\My company\MyNotePad","1" will remove the SOFTWARE\My company\MyNotePad key (and entries) under the HKEY_CURRENT_USER rootkey.
"KEY","0",".ani","1" will remove the key ".ani" under the HKEY_CLASSES_ROOT rootkey.
You want to remove from "C:\windows\myapp.ini" the following key:
[Settings]
Path=C:\Program Files\My Application.
The Parameters property should be set to:
"ENT","C:\windows\myapp.ini","Settings","Path"
You do not want the uninstaller to remove the following installed file: %DESTPATH%\myfile.lic
Add an "ucDonotRemove" uninstall command and enter this line as Parameters:
"FILE","%DESTPATH%\myfile.lic"
with all quotes.You do not want the uninstaller to remove the registry entry named "Entry1" in the following key "SOFTWARE\My company\My program":
Add an "ucDonotRemove" uninstall command and enter this line as Parameters:
"KEY","SOFTWARE\My company\My program","Entry1"
with all quotes.
Paquet Builder Help - Copyright © G.D.G. Software. All rights reserved.