NWEnumNetAddresses

Enumerates all the network addresses used by the specified NetWare server.

Local Servers:blocking
Remote Servers:blocking
NetWare Server: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 NWEnumNetAddresses ( 
     NWCONN_HANDLE                     conn, 
     pnuint32                          searchNumber 
     SERVER_AND_VCONSOLE_INFO N_FAR   *serverTimeAndVConsoleInfo, 
     pnuint16                          reserved, 
     NW_GUID N_FAR                    *fseServerGUID, 
     nuint32                           itemsInArray, 
     pnuint32                          itemsReturned, 
     NWFSE_NETWORK_ADDRESS N_FAR      *fseNetworkAddresses);

Delphi Syntax

  uses calwin32 
  
  Type
     NW_GUID = Array[0..15] of nuint8;   
   
  Function NWEnumNetAddresses(
    conn : NWCONN_HANDLE;   
    Var searchNumber : nuint32; 
     	Var serverTimeAndVConsoleInfo : SERVER_AND_VCONSOLE_INFO;   
    	reserved : pnuint16;  
    	Var fseServerGUID : NW_GUID; 
    	itemsInArray : nuint32;   
    Var 	itemsReturned : nuint32;  
    Var fseNetworkAddresses: NWFSE_NETWORK_ADDRESS
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
searchNumber
(IN/OUT) Points to the iteration value used for subsequent calls (set to zero initially).
serverTimeAndVConsoleInfo
(OUT) Points to SERVER_AND_VCONSOLE_INFO, which contains the server console version.
reserved
Is reserved for future use.
fseServerGUID
(OUT) Points to NW_GUID, which contains the server's Global Universal Identification (GUID).
itemsInArray
(IN) Specifies the size of the array pointed to by fseNetworkAddresses.
itemsReturned
(OUT) Points to the actual number of addresses returned by fseNetworkAddresses.
fseNetworkAddresses
(OUT) Points to NWFSE_NETWORK_ADDRESS, which contains the network address information.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x880E

NWE_BUFFER_OVERFLOW

0x8977

NWE_BUFFER_TOO_SMALL

0x897E

NCP_BOUNDARY_CHECK_FAILED

Remarks

You need to allocate enough space for the address in the address field of NWFSE_NETWORK_ADDRESS, or NWE_BUFFER_OVERFLOW will be returned.

Upon return, the addressSize field in NWFSE_NETWORK_ADDRESS will contain the size needed to read the address. To call NWEnumNetAddresses iteratively and avoid the NWE_BUFFER_OVERFLOW error, reset the addressSize field to the maximum buffer size.

NCP Calls