NWDownFileServer

Allows a supervisor to bring down a NetWare server from a remote console.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Server Environment

Syntax

  #include <nwserver.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWDownFileServer  ( 
     NWCONN_HANDLE   conn,  
     nuint8          forceFlag);

Delphi Syntax

  uses calwin32 
   
  Function NWDownFileServer 
    (conn : NWCONN_HANDLE; 
     forceFlag : nuint8 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
forceFlag
(IN) Specifies a flag enabling the server to shut down when files are still open (0=enabled).

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89C6

NO_CONSOLE_PRIVILEGES

0x89FF

Down Failure

Remarks

If forceFlag is zero, the server shuts down even if files are open. If forceFlag is non-zero and any files are in use or open, 0x89FF (failure) is returned, and the server stays up. If no files are open or in use, the server shuts down, and SUCCESSFUL returns.

To call NWDownFileServer, you must have console operator rights.

NCP Calls