SdFinishUpdateReboot

InstallShield 2016 » InstallScript Language Reference

Project • This information applies to the following project types:

•

InstallScript

•

InstallScript MSI

The SdFinishUpdateReboot function at the end of your installation displays a dialog that indicates that the installation is complete. The dialog gives the end user the option to restart the system and to check for application updates. Restarting the system enables changes to Autoexec.bat, Config.sys, and some .ini files to take effect.

Note • SdFinishUpdateReboot does not check for updates; to check for updates, add FlexNet Connect API calls in your InstallScript code. For more information, see the FlexNet Connect SDK documentation.

Syntax

SdFinishUpdateReboot ( szTitle, szMsg1, nDefOption, szMsg2, nChkUpdate, nReserved );

Parameters

SdFinishUpdateReboot Parameters

Parameter

Description

szTitle

Specifies the title of the dialog. To display the default title (“Setup Complete”), pass a null string (“”) in this parameter.

szMsg1

Specifies the text to display at the top of the dialog, informing the end user about the end of the installation. To display the default instructions for this dialog, pass a null string (“”) in this parameter.

nDefOption

Specifies a default radio button selection. Pass one of the following predefined constants in this parameter:

•

SYS_BOOTMACHINE—Reboot the computer when the setup is finished.

•

0—Do not reboot the computer.

szMsg2

Specifies the text to display at the bottom of the dialog, giving the end user information about what to do. To display the default instructions, pass a null string (“”).

nvChkUpdate

Returns the state of the FlexNet Connect check box:

•

0—Check box is not selected. Do not check for application updates.

•

Other than 0—Check box is selected. Check for application updates.

nReserved

Pass zero in this parameter. No other value is allowed.

Return Values

SdFinishUpdateReboot Return Values
Return Value	Description
WILL_REBOOT	Indicates that the end user chose to reboot the system.
NEXT (1)	Indicates that the end user chose not to reboot the system or restart Windows.
< 0	Indicates that the end user chose to either reboot the system or restart Windows, but the reboot or restart failed.

Note • Because SdFinishUpdateReboot announces the end of the installation, the Back button is disabled.

Additional Information

To view an example of this or other dialogs for your installation, use the Dialog Sampler. In InstallShield, on the Tools menu, point to InstallScript, then click Standard Dialog Sampler or Skinned Dialog Sampler.

SdFinishUpdateReboot

InstallShield 2016 Help Library

May 2017