InstallShield 2012 Spring Express Edition User Guide

Chapter 10: Customizing Installation Behavior
Using Custom Actions
Note: InstallShield sequences the serial number DLL file custom action after any user-defined custom actions. Thus, if you
add your own custom action and schedule it after the Customer Information dialog, the installation launches this custom
action before the serial number DLL file custom action.
Custom Action Gallery
The Custom Action gallery contains preconfigured custom actions that achieve common functionality.
The custom actions contained in this gallery do not require any input from you. They are designed to be
added to your installation project and run during installation. To insert an action from your gallery into
your installation, right-click one of the items in the Custom Actions view, point to Add from Gallery, and
then click the custom action that you want to add to your project.
Currently, the only action listed in this gallery is Schedule Reboot at End action. If you add this action to
your project, it is automatically added to the After Setup Complete Success dialog part of the installation.
This action forces the target machine to reboot after the installation completes, allowing .dll files and
other files to register with the system at startup. Changing any of this custom action’s settings or
scheduling it for a different part of the installation is not recommended. For example, if you reschedule
it, your installation may cause the target machine to restart before the file transfer has completed.
Checking if a Product Is Installed
The following code will check if a product with a ProductCode of {8FC71000-88A0-4B41-82B8-
8905D4AA904C} is installed on the machine. This code can be used as a New Style DLL Custom Action.
UINT __stdcall CheckProduct(MSIHANDLE hInstall)
{
int RetVal = 0;
RetVal = MsiQueryProductState("{8FC71000-88A0-4B41-82B8-8905D4AA904C}");
if (RetVal==5))
{
MessageBox(GetForegroundWindow(),TEXT("Installed"),TEXT("My Product"), MB_OK);
return 1;
}
else
{
MessageBox(GetForegroundWindow(),TEXT("Not Installed"),TEXT("My Product"), MB_OK);
return 0;
}
}
The following table lists the return values of MsiQueryProductState:
Table 10-2: Return Values of MsiQueryProductState
Return Value Description
–1 The product is neither advertised nor installed.
1 The product is advertised but not installed.
2 The product is installed for a different user.
InstallShield 2012 Spring Express Edition User Guide ISE-1900-UG00 233