OnFilesInUse

InstallShield 2018 » InstallScript Language Reference

Project • This information applies to InstallScript MSI projects.

The OnFilesInUse event handler is called in an InstallScript MSI installation when the Windows Installer sends an INSTALLMESSAGE_FILESINUSE message to the installation.

The szMessage parameter contains the string that the Windows Installer provides. This parameter indicates the files that are in use. The SdFilesInUse function parses this string appropriately.

By default, the OnFilesInUse event handler displays the SdFilesInUse dialog. The event handler returns the value that the dialog returns, and the value is then passed back to the Windows Installer to indicate how the message was handled and what action the Windows Installer should take.

Syntax

OnFilesInUse (szMessage);

Parameters

OnFilesInUse Parameters

Parameter

Description

szMessage

String provided by the Windows Installer indicating the files that are in use. The SdFilesInUse function parses this string.

Return Values

OnFilesInUse Return Values

Return Value

Description

IDCANCEL

Indicates that the installation should be cancelled.

IDRETRY

Indicates that the Windows Installer should recheck for in-use files and send the INSTALLMESSAGE_FILESINUSE message if it still needed.

IDIGNORE

Indicates that the Windows Installer should ignore the fact that the files are in use and should continue the installation.

See Also