RebootDialog

The RebootDialog function displays a dialog that allows the end user to reboot the computer. The selected option is performed at the end of the installation.

When you call a function with the SHAREDFILE or LOCKEDFILE option and locked .dll or .exe files are encountered, updated versions of the locked files are copied to the target system and the system variable BATCH_INSTALL is set to TRUE. RebootDialog automatically commits the locked files for update when the system is restarted, unless the user selects the No, I will restart my computer later option.

InstallShield makes every attempt not to restart the system when other instances of InstallShield are running. Because of this, you must make sure all other instances of InstallShield are shut down before calling RebootDialog. Your message to end users should request that they ensure all other applications are shut down before restarting the system.

An alternative to the RebootDialog function is SdFinishReboot, which has a better look and feel than the RebootDialog dialog.

Syntax

Parameters

RebootDialog Parameters
Parameter	Description
szTitle	Specifies the title of the dialog. To display the default title Restarting Windows, pass a null string ("") in this parameter.
szMsg	Specifies the message to display in the dialog. To display the default instructions for this dialog, pass a null string ("") in this parameter.
nDefChoice	Specifies the default option button selection. Pass one of the following predefined constants in this parameter: SYS_BOOTMACHINE—The option to reboot the computer (Yes, I want to restart my computer now) is the default option button selection. 0—The option to not restart the computer (No, I will restart my computer later) is the default option button selection.

Return Values

RebootDialog Return Values
Return Value	Description
WILL_REBOOT	Indicates that the end user selected the Yes, I want to restart my computer now option button.
0	Indicates that the end user selected the No, I will restart my computer later option button.

Additional Information

The message box that is displayed by the RebootDialog function cannot be displayed with a skin; it appears the same regardless of whether you have specified a skin.