Novell Documentation: NLM & NetWare Libraries for C

NWGetKnownServersInfo

Returns information about servers advertising themselves to the server with SAP packets.

Local Servers:blocking
Remote Servers:blocking
NetWare Server: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 <nwfse.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWGetKnownServersInfo 
    (NWCONN_HANDLE                     conn,  
     nuint32                           startNum,  
     nuint32                           serverType,  
     NWFSE_KNOWN_SERVER_INFO  N_FAR   *fseKnownServerInfo);

Delphi Syntax

  uses calwin32 
   
  Function NWGetKnownServersInfo 
    (conn : NWCONN_HANDLE; 
     startNum : nuint32; 
     serverType : nuint32; 
     Var fseKnownServerInfo : NWFSE_KNOWN_SERVER_INFO 
  ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle.

startNum

(IN) Specifies the cumulative number of servers returned from all previous calls; normally, zero (0) for the first call.

serverType

(IN) Specifies the server type:

0x0400 NetWare server
0xFFFF All other server types

fseKnownServerInfo

(OUT) Points to NWFSE_KNOWN_SERVER_INFO containing known server information.

Return Values

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

0x0000	SUCCESSFUL
0x8801	INVALID_CONNECTION
0x8901	Returned from NWFSE_KNOWN_SERVER_INFO when no more items are found
0x890A	NLM_INVALID_CONNECTION
0x897E	NCP_BOUNDARY_CHECK_FAILED
0x89C6	NO_CONSOLE_PRIVILEGES

Remarks

To call NWGetKnownServersInfo, you must have console operator rights.

startNum should be set to zero on the first call. On subsequent calls, the value returned in the numberOfEntries field in the SERVER_AND_VCONSOLE_INFO structure should be added to the value in startNum until INVALID_CONNECTION is returned.

NCP Calls