INtime SDK Help
ShutdownRtHost
INtime SDK v6 > About INtime > INtime Kernel > Status > ShutdownRtHost

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

Versions Defined in Include Link to
INtime 5.0 intime/rt/include/rtbase.h rt.h rt.lib
See Also

DSM