Windows Installer Editor Reference
464
Custom Action Reference
appropriate platform. Example: Your .WSI contains a 32-bit release, an x64 release,
and an Itanium release. You add three Call Custom .DLL actions to the project: one
to call ABC32.dll, one to call ABCx64.dll, and one to call ABCItanium.dll. Place each
custom action inside a condition block that checks for the appropriate platform.
z
Before you add this custom action, add the file to be called to the Files page in
Installation Expert.
z
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 .DLL that facilitates the passing of parameters.
Usage
Double-click the custom action and complete the Details tab:
z
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.
z
DLL File
Specify a .DLL file to call during installation. It must have already been added to this
installation.
z
Function Name
Type the name of the function within the .DLL file to call.
z
Parameter List
In the parameter list, specify the parameters to send to the .DLL.
z
Return Value Type
Select the data type of the return value that is returned from the .DLL.
z
Returned Property
Type or select a property name. The return value of the function call will be put into
this property.
In the Execute Immediate or User Interface sequences only, you can send Windows
Installer properties to the .DLL function as parameters.
See
Configuring .DLL Parameter Settings
on page 464.
See also:
Guidelines for Calling .DLLs
on page 457
Guidelines for Custom Action Location
on page 454
Using the Custom Action Properties Tab
on page 490
Using the Custom Action Location Tab
on page 488
Configuring .DLL Parameter Settings
When you add a Call Custom .DLL custom action, use the DLL Parameter Details dialog
box to add parameters.
