Self-register a file (ActiveX, OLE)

This action registers .dll and ActiveX control files as command components in the Windows registry. It is similar to the Windows REGSVR32.EXE utility except that you do not need to ship this tool with your package if you use this custom action.

Moreover this custom action can also add the registered file to the Windows shared file list (it becomes application-shared). Shared means that this file may be used by different applications, and consequently should be removed with care (have a look at the Register a shared file custom action).

Finally if the package includes a uninstaller, this custom action may also put a reference into the uninstaller log, so the registered DLL or OCX file is unregistered when the package is uninstalled by end users. Note that the file will only be unregistered and removed if no other application uses it.

Property Name

Data Type

Description

AddUninstReference

Boolean

If true, the package will add a reference to this file in the uninstaller log file. The file will be first unregistered and then safely removed if no other application uses it.
ServerFileString

Full path to the file you want to self-register. The file must exist when this custom action is executed. For example %SYS%\Control.ocx

SharedLegacyFileBooleanTells the package whether the file should be registered as shared or not. By default you should always set this option to true, except if you are sure that the file is never shared with other applications.

This custom action should always be put in the "After File Extraction" event, especially if AddUninstReference is set to True.


  Paquet Builder Help - Copyright © G.D.G. Software. All rights reserved.