User Guide
509
Also see:
Guidelines for Calling .DLLs on page 502
Configuring .DLL Parameter Settings on page 510
Guidelines for Custom Action Location on page 499
Using the Custom Action Properties Tab on page 534
Using the Custom Action Location Tab on page 532
Call Custom DLL From Installed Files
This custom action calls a .DLL file that is installed by this installation. Use this custom
action to call the .DLL during installation, while leaving the .DLL on the destination
computer as part of the installation.
Tips
! You can send a variable parameter list to the .DLL.
! First add the file to be called to the Files page in Installation Expert.
! Shaded areas of MSI Script indicate restricted placement for this custom action;
because this custom action calls an installed file, it must run after files are installed.
Note
Before being passed to Windows Installer, calls you make with Call Custom DLL actions are
passed through a Wise-created .DLL, which facilitates the passing of parameters.
Usage
Double-click the custom action and complete the Details tab:
! Custom Action Name
Enter a unique name that begins with a letter or underscore. It can contain numbers
and periods. It must not match the name of any Windows Installer standard action.
See Standard Actions Reference in the Windows Installer SDK Help.
! DLL File. Specify a .DLL file to call during installation. It must have already been
added to this installation via the Files page.
! Function Name
Type the name of the function within the .DLL file to call.
! Parameter List
In the parameter list, specify the parameters to send to the .DLL.
! Return Value Type
Select the data type of the return value that is returned from the .DLL.
! Returned Property
Type or select a property name. The return value of the function call will be put into
this property.
Also see:
Guidelines for Calling .DLLs on page 502
Configuring .DLL Parameter Settings on page 510
Guidelines for Custom Action Location on page 499
Using the Custom Action Properties Tab on page 534
Using the Custom Action Location Tab on page 532