Before Move Data Handlers

InstallShield 2014 ยป InstallScript Language Reference

The following event handlers are triggered before files are transferred to the target computer. Most of these events are also triggered during a maintenance setup.

Before Move Data Handlers

Event Handler

Project Type

Description

OnBegin

InstallScript

InstallScript MSI

In InstallScript projects: Called directly by the framework after Initialization events.

In InstallScript MSI projects: Responds to the Begin event, the first redefinable event in a setup.

OnAppSearch

InstallScript

InstallScript MSI

In InstallScript projects: Called directly by the framework after OnBegin.

In InstallScript MSI projects: Responds to the Application Search event. Code this handler in installations that must search for a specific application on the target computer.

OnCCPSearch

InstallScript

InstallScript MSI

In InstallScript projects: Called directly by the framework after AppSearch.

In InstallScript MSI projects: Responds to the Upgrade Compliance event. Code this handler in installations that must search for an application whose presence qualifies the end user to install your application.

OnFirstUIBefore

InstallScript

InstallScript MSI

In InstallScript projects: Called by the framework when the setup is running in first install mode. By default, this event displays UI allowing the end user to specify installation parameters.

In InstallScript MSI projects: Responds to the First UI Before event by displaying dialogs that gather information from the end user for the first installation of an application.

OnMaintUIBefore

InstallScript

InstallScript MSI

In InstallScript projects: Called by OnShowUI when the installation is running in maintenance mode. OnShowUI can be customized to control whether this event is called.

In InstallScript MSI projects: Responds to the MaintenanceUIBefore event by displaying dialogs that gather information from the end user for a maintenance installation of an application.

OnUpdateUIBefore

InstallScript

Called by OnShowUI when the setup is running in update mode. By default this event displays UI that allows the end user to update the application to the current version.

OnSuiteInstallBefore

InstallScript

The OnSuiteShowUI event calls the OnSuiteInstallBefore event. By default, OnSuiteInstallBefore is called to initialize information, such as the selection of features, that is necessary to perform file transfer.

Note: This event is not called automatically in a program...endprogram style installation.

OnSuiteMaintBefore

InstallScript

The OnSuiteShowUI event calls the OnSuiteMaintBefore event. By default, OnSuiteMaintBefore is called to initialize information, such as the selection of features, that is necessary to perform file transfer.

Note: This event is not called automatically in a program...endprogram style installation.

OnSuiteUpdateBefore

InstallScript

The OnSuiteShowUI event calls the OnSuiteUpdateBefore event. By default, OnSuiteUpdateBefore is called to initialize information, such as the selection of features, that is necessary to perform file transfer.

Note: This event is not called automatically in a program...endprogram style installation.

OnSQLLogin

InstallScript MSI

In InstallScript MSI projects: Responds to the First UI Before event. This event handler function creates a dialog which is used by the script to specify SQL login credentials. These credentials include the login ID and password.

OnSQLServerInitialize

InstallScript

Called by OnFirstUIBefore to establish any connections necessary for SQL Server support. This function will initialize the SQL Server runtime and attempt to make any necessary SQL Server connections displaying a login dialog for each one.

OnSQLServerInitializeMaint

InstallScript

Called by OnMaintUIBefore to establish any connections necessary for SQL Server support.

OnIISInitialize

InstallScript

The OnIISInitialize event is called by OnFirstUIBefore to initialize the IIS run time.

Note: This event is not called automatically in a program...endprogram style installation.

OnXMLInitialize

InstallScript

The OnXMLInitialize event is called by OnFirstUIBefore to initialize the XML runtime.

Note: This event is not called automatically in a program...endprogram style installation.

See Also