NWDSOpenConnToNDSServer

Locates a connection to a specific server.

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 <nwdsconn.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE) NWDSOpenConnToNDSServer  ( 
     NWDSContextHandle   context,  
     pnstr8              serverName,  
     pNWCONN_HANDLE      connHandle);

Pascal

  uses netwin32 
   
  Function NWDSOpenConnToNDSServer 
   (context : NWDSContextHandle; 
     serverName : pnstr8; 
     Var connHandle : NWCONN_HANDLE 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request or NULL for the preferred tree.
serverName: (IN) Points to the server to receive the request.
connHandle: (OUT) Points to the connection handle.

Return Values

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

Remarks

NWDSOpenConnToNDSServer allows you to locate a connection to a specific server. The form of the name depends upon the settings in the context handle. If the default values have not been modified, this is a partial dot name relative to the current NDS context. For more information, see Section 1.1, Context Handles.

The serverName is resolved using eDirectory and a connection is returned.When finished with the connection, the application must close the connection using NWCCCloseConn.

NCP Calls

None