ShutdownServer

Syntax

  #include <netware.h>
  
  int ShutdownServer (
     scr_t           scrID,
     uint8_t         forceDown,
     const char     *alternateMessage,
     unsigned long   flags);
  

Parameters

scrID

Specifies a screen, such as your own private screen (if that is where management is being controlled from) or a system console screen ID. To specify the system console, pass 0.

forceDown

Specifies whether to bring the server down without sending a notification to NLM applications that have registered for a “down server event” notification:

• TRUE Do not send notifications.
• FALSE Send notifications.

alternateMessage

Points to a null-terminated ASCII string that contains a message to send to all logged-in remote connections. If NULL is passed, the default message (“File Server %s is down. Connection terminated.”) is broadcast to each logged-in client. This string must be shorter than 100 characters.

flags

Specifies how the server should shutdown with one of the following flags:

Flag	Value	Description
SHUTDOWN_RESET	0x00000001	Shuts down the server and exits to the DOS prompt on the boot partition. The server is reset with the warm boot flag, so it reboots immediately.
SHUTDOWN_POWEROFF	0x00000002	Turns off the power to the computer when the shutdown process is completed. Not currently implemented.

See Also

• RestartServer
• StopServer