InstallShield 2019 » InstallScript Language Reference
Project • This information applies to the following project types:
| • | InstallScript |
| • | InstallScript MSI |
The RebootDialog function displays a message box that enables end users to specify whether they want to restart 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.
The InstallScript engine makes every attempt not to restart the system when other instances of the installation are running. Because of this, you must make sure all other instances of the installation 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.
Note • An alternative to the RebootDialog function is SdFinishReboot, which has a better look and feel than the RebootDialog dialog.
Syntax
RebootDialog ( szTitle, szMsg, nDefChoice );
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:
|
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.
See Also
InstallShield 2019 Help LibraryApril 2019 |
Copyright Information | Flexera |