NWGetFileServerInformation(3nw)


NWGetFileServerInformation -- returns NetWare object information

Synopsis

   #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);

Description

The parameters are as follows:

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 4.0 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

0x0000
SUCCESSFUL

0x8996
SERVER_OUT_OF_MEMORY

Notices

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.

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

Substititue 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.

Services

File Server Environment

NCP calls

0x2222 23 17
Get File Server Information

References

NWGetFileServerInformation(3nw), NWGetFileServerVersionInfo(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.