NWDisableFileServerLogin

Allows an operator to instruct the NetWare server to refuse new login requests.

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  NWDisableFileServerLogin  ( 
     NWCONN_HANDLE   conn);

Delphi Syntax

  uses calwin32 
   
  Function NWDisableFileServerLogin 
    (conn : NWCONN_HANDLE 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.

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

Remarks

NWDisableFileServerLogin is usually made during some crucial time-before taking the server down, for instance.

It is recommended that caution be used with NWDisableFileServerLogin. If, after calling NWDisableFileServerLogin, the service connection to the NetWare server is lost or destroyed, a new connection cannot be created; therefore, the user cannot log in again. If no other user on the server has SUPERVISOR privileges, the server must be brought down from the console connected to the server and rebooted before any new users (including the SUPERVISOR) can access it.

To call NWDisableFileServerLogin, you must have console operator rights.

NCP Calls