System

InstallShield 2019 » InstallScript Language Reference

The System function is documented for backward compatibility with InstallShield Professional. With newer versions of InstallShield, RebootDialog and SdFinishReboot are better functions to use to restart Windows or reboot the system. Of these two, SdFinishReboot provides the most functionality. Refer to the individual function descriptions to see which one best meets your needs.

Use the System function to restart Windows or reboot the system after an installation has completed. System does not perform an aborted setup—that is, it does not remove installed files. However, InstallShield does remove any temporary directories and temporary files it placed on the system to carry out the setup. To reboot the system immediately after calling the System function, use the exit keyword immediately after calling the System function.

Some systems may not restart or may hang when this function is called. Many setup routines (including installation for system software such as MS-DOS) display a warning message to the user before they restart the system. This warning message indicates what is happening and instructs the user to reboot the system manually if the command fails.

Note • This function calls the Windows API ExitWindows. Due to the wide variety of BIOS types, this function is highly dependent on the BIOS interaction with the system.

Syntax

System ( nOp );

Parameters

System Parameters

Parameter

Description

nOp

Specifies which action to perform after terminating the setup. Pass the following predefined constant in this parameter:

SYS_BOOTMACHINE—Reboots the system.

See Also