Shuts down an INtime Distributed RTOS host system, with an optional delay and optional automatic reboot.

BOOLEAN ShutdownRtHost(BOOLEAN bReboot, DWORD dwMillisecondsDelay);

Parameters

bReboot

If TRUE causes the system to be restarted after the shutdown process is complete.

dwMillisecondDelay

If non-zero causes the shutdown process to pause for dwMilliseconds ms before completing the process.

Remarks

This call initiates the shutdown process. The steps taken are as follows:

1. Send a KERNEL_STOP_PENDING to the DSM, which then distributes the message to any processes listening for system events
2. Wait for the specified delay
3. Send a KERNEL_STOPPING message to DSM
4. Detach and close the system disk device
5. If bReboot is TRUE, restart the system, else stop the system

Return Values

TRUE

Success.

FALSE

Failure. To determine the status, call GetLastRtError.

Status

E_CONTEXT

The local host is not an INtime Distributed RTOS host. This call has no effect on an INtime for Windows host.

Requirements