NWGetNetworkRoutersInfo

Returns information about the routers on a network.

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  NWGetNetworkRoutersInfo  ( 
     NWCONN_HANDLE                        conn,  
     nuint32                              networkNum,  
     nuint32                              startNum,  
     NWFSE_NETWORK_ROUTERS_INFO  N_FAR   *fseNetworkRoutersInfo);
  

Delphi Syntax

  uses calwin32 
   
  Function NWGetNetworkRoutersInfo 
    (conn : NWCONN_HANDLE; 
     networkNum : nuint32; 
     startNum : nuint32; 
     Var fseNetworkRoutersInfo : NWFSE_NETWORK_ROUTERS_INFO 
  ) : NWCCODE; 
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
networkNum
(IN) Specifies the number of the network for which to return information.
startNum
(IN) Specifies the value returned in numberOfEntries in NWFSE_NETWORK_ROUTERS_INFO; normally, zero (0) on the first call.
fseNetworkRoutersInfo
(OUT) Points to NWFSE_NETWORK_ROUTERS_INFO returning network routers information.

Return Values

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

0x0000

SUCCESSFUL

0x8801

Invalid Network Number or Start Number

0x890A

NLM_INVALID_CONNECTION

0x897E

NCP_BOUNDARY_CHECK_FAILED

Remarks

To call NWGetNetworkRoutersInfo, you must have console operator rights.

NCP Calls

See Also

NWGetKnownNetworksInfo, NWGetNetworkRouterInfo