NWDSGetObjectHostServerAddress

Returns the addresses of the server where an object is located.

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 <nwdsmisc.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSGetObjectHostServerAddress  ( 
     NWDSContextHandle   context,  
     pnstr8              objectName,  
     pnstr8              serverName,  
     pBuf_T              netAddresses);

Pascal

  uses netwin32 
   
  Function NWDSGetObjectHostServerAddress 
    (context : NWDSContextHandle; 
     objectName : pnstr8; 
     serverName : pnstr8; 
     netAddresses : pBuf_T 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
objectName: (IN) Points to the name of an eDirectory object.
serverName: (OUT) Points to the name of the server where an object is located.
netAddresses: (OUT) Points to a buffer containing the network addresses of the associated server.

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

NWDSGetObjectHostServerAddress works only for objects having "Host Server" as an attribute (such as Volume objects). Servers can have more than one address, such as an IPX and an IP address. The netAddresses parameter receives these addresses.

For information on retrieving the addresses from the buffer, see Finding the Host Server of an Object.

NCP Calls

0x2222 23 17 Get File Server Information
0x2222 23 22 Get Station’s Logged Info (old)
0x2222 23 28 Get Station’s Logged Info
0x2222 104 01 Ping for eDirectory NCP
0x2222 104 02 Send eDirectory Fragmented Request/Reply