NWGetFileServerInformation

Returns several items, including NetWare server name, NetWare versions, maximum and peak connections, number of licensed connections currently in use, maximum volumes supported, and SFT and TTS level of support.

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  NWGetFileServerInformation  ( 
     NWCONN_HANDLE   conn,  
     pnstr8          serverName,  
     pnuint8         majorVer,  
     pnuint8         minVer,  
     pnuint8         rev,  
     pnuint16        maxConns,  
     pnuint16        maxConnsUsed,  
     pnuint16        connsInUse,  
     pnuint16        numVolumes,  
     pnuint8         SFTLevel,  
     pnuint8         TTSLevel);

Delphi Syntax

  uses calwin32 
   
  Function NWGetFileServerInformation 
    (conn : NWCONN_HANDLE; 
     serverName : pnstr8; 
     majorVer : pnuint8; 
     minVer : pnuint8; 
     rev : pnuint8; 
     maxConns : pnuint16; 
     maxConnsUsed : pnuint16; 
     connsInUse : pnuint16; 
     numVolumes : pnuint16; 
     SFTLevel : pnuint8; 
     TTSLevel : pnuint8 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
serverName
(OUT) Points to the name of NetWare server (48 bytes, optional).
majorVer
(OUT) Points to the major NetWare version number (optional).
minVer
(OUT) Points to the minor NetWare version number (optional).
rev
(OUT) Points to the revision number of the NetWare OS on NetWare server (optional).
maxConns
(OUT) Points to the maximum number of connections the server will support (optional). The connection table for NetWare 4.x is dynamic. This number will be the maximum of what the table has grown to.
maxConnsUsed
(OUT) Points to the highest number of connections simultaneously in use (optional).
connsInUse
(OUT) Points to the number of licensed connections the server currently has in use (optional).
numVolumes
(OUT) Points to the maximum number of volumes the server will support (optional).
SFTLevel
(OUT) Points to the SFT level the server supports (optional).
TTSLevel
(OUT) Points to the TTS Level of NetWare server operating system (optional).

Return Values

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

0x0000

SUCCESSFUL

0x8996

SERVER_OUT_OF_MEMORY

Remarks

NWGetFileServerInformation will only return the number of licensed connections in use. For NetWare 3.x, all connections are considered licensed. For NetWare 4.x, many connections do not require a server license and will not be returned in connsInUse.

Under NETX, if an invalid connection handle is passed to conn, NWGetFileServerInformation will return 0x0000. NETX will pick a default connection handle if the connection handle cannot be resolved.

The buffer allocated to receive NetWare server name should be at least 48 bytes long.

Substitute NULL for a parameter if a return is not desired. However, all parameter positions must be filled. Any client can call NWGetFileServerInformation without logging in to the specified NetWare server.

NCP Calls

See Also

NWGetFileServerInformation, NWGetFileServerVersionInfo