NWDSGetServerAddresses2

Returns the network addresses of the server associated with a connection handle.

Local Servers:blocking

Remote Servers:blocking

NetWare Server:4.x, 5.x, 6.x

Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP

Library:Cross-Platform NDS (NET*.*)

Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsdsa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSGetServerAddresses2  ( 
     NWDSContextHandle   context,  
     NWCONN_HANDLE       connHandle,  
     pnuint32            countNetAddress,  
     pBuf_T              netAddresses);

Pascal

  uses netwin32 
   
  Function NWDSGetServerAddresses2 
    (context : NWDSContextHandle; 
     connHandle : NWCONN_HANDLE; 
     countNetAddress : pnuint32; 
     netAddresses : pBuf_T 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
connHandle: (IN) Specifies the connection handle for the target server.
countNetAddress: (OUT) Points to the number of network addresses contained in the netAddresses parameter.
netAddresses: (OUT) Points to a buffer containing the network address associated with the server.

Return Values

These are common return values.

0x0000 0000	SUCCESSFUL
0x8996	SERVER_OUT_OF_MEMORY
0x89E2	TOO_FEW_FRAGMENTS
0x89E3	TOO_MANY_FRAGMENTS
0x89E4	PROTOCOL_VIOLATION
0x89E5	SIZE_LIMIT_EXCEEDED
0x89FD	UNKNOWN_REQUEST
0x89FD	INVALID_PACKET_LENGTH
0x89FE	BAD_PACKET
0x89FF	Failure not related to eDirectory
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

Servers can have more than one address, such as an IPX and an IP address. The netAddresses parameter receives these addresses.

For more information, see Retrieving Addresses of a Connected Server.

NCP Calls

0x2222 104 02 Send eDirectory Fragmented Request/Reply
53 Get Server Address