Novell Documentation: NLM & NetWare Libraries for C

NWGetServerInfo

Returns the address and the number of hops to the server specified by serverName in relation to the server represented by conn .

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 NWGetServerInfo ( 
     NWCONN_HANDLE              conn,  
     nuint32                    serverType,  
     const nstr8 N_FAR         *serverName,  
     NWFSE_SERVER_INFO N_FAR   *fseServerInfo);

Delphi Syntax

  uses calwin32 
   
  Function NWGetServerInfo 
    (conn : NWCONN_HANDLE; 
     serverType : nuint32; 
     const serverName : pnstr8; 
     Var fseServerInfo : NWFSE_SERVER_INFO 
  ) : NWCCODE;

Parameters

conn: (IN) Specifies the NetWare server connection handle.
serverType: (IN) Specifies the type of server to search for, such as a file server (0x0400).
serverName: (IN) Points to the name of the server for which to search.
fseServerInfo: (OUT) Points to NWFSE_SERVER_INFO containing server information.

Return Values

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

0x0000	SUCCESSFUL
0x8801	Invalid Server Name
0x8901	Invalid Server Type
0x890A	NLM_INVALID_CONNECTION
0x897E	NCP_BOUNDARY_CHECK_FAILED
0x89C6	NO_CONSOLE_PRIVILEGES
0x89FB	INVALID_PARAMETERS

Remarks

To call NWGetServerInfo, you must have console operator rights to the 4.x server indicated by conn. serverType can indicate either a 3.x or 4.x server.

NCP Calls