NWDSResolveName

Returns a connection handle and an object ID for the object name.

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 <nwdsname.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSResolveName  ( 
     NWDSContextHandle     context,  
     pnstr8                objectName,  
     NWCONN_HANDLE N_FAR  *conn,  
     pnuint32              objectID);

Pascal

  uses netwin32 
     
   
  Function NWDSResolveName 
    (context : NWDSContextHandle; 
     objectName : pnstr8; 
     Var conn : NWCONN_HANDLE; 
     objectID : pnuint32 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request.
objectName: (IN) Points to the name of the object to get the ID for.
conn: (OUT) Points to the connection handle where the object resides.
objectID: (OUT) Points to the eDirectory object ID.

Return Values

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

Remarks

The returned connection handle is the NetWare server where the object is stored.

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