SdFinishEx

InstallShield 2014 » InstallScript Language Reference

Project: This information applies to the following project types:

InstallScript
InstallScript MSI

The SdFinishEx function calls either SdFinish or SdFinishReboot to display a dialog that informs the end user that the installation is complete and provides information or options. If the system variable BATCH_INSTALL is equal to FALSE (indicating that no locked files were encountered during the setup), SdFinishEx calls SdFinish to display the dialog. If BATCH_INSTALL is equal to a non-zero value, SdFinishEx calls SdFinishReboot to display the dialog.

To insert the product name into the messages and check box descriptions, use the place holder %P in the strings passed in szMsg1, szMsg2, szOpt1, and szOpt2.

Syntax

SdFinishEx (szTitle, szMsg1, szMsg2, szOpt1, szOpt2, bvOpt1, bvOpt2);

Parameters

The parameters are the same as those of SdFinish. If BATCH_INSTALL is equal to TRUE, these parameters are ignored and SdFinishReboot("", "", SYS_BOOTMACHINE, "", 0) is called.

Return Values

SdFinishEx Return Values

Return Value

Description

0

Indicates that SdFinish was called.

NEXT (1)

Indicates that SdFinishReboot was called and the user chose not to reboot the computer.

< 0

Indicates that SdFinishReboot was called and the user chose to reboot the computer, but the reboot failed.

Additional Information

To display non-default text in the SdFinishReboot dialog, do not call SdFinishEx. Instead, use code like the following:

if (!BATCH_INSTALL) then

    SdFinish( szTitle, szMsg1, szMsg2,

        szOption1, szOption2, bOpt1, bOpt2 );

else

    SdFinishReboot( szRebootTitle, szRebootMsg1,

        SYS_BOOTMACHINE, szRebootMsg2, 0 );

endif;

See Also