NWDSGetMonitoredConnRef

Retrieves a monitored connection reference.

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) NWDSGetMonitoredConnRef  ( 
     NWDSContextHandle   context,  
     pnuint32            connRef);

Pascal

  uses netwin32 
   
  Function NWDSGetMonitoredConnRef 
    (context : NWDSContextHandle; 
     Var connRef : nuint32 
  ) : NWDSCCODE;

Parameters

context: (IN) Specifies the NDS context for the request or NULL for the preferred tree.
connRef: (OUT) Points to the connection reference.

Return Values

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

Remarks

A monitored connection reference is set only if NWDSLogin has been called. For multiple tree support, the tree name specified in the context handle is used to specify which monitored connection reference to retrieve.

If the tree name is not set in the context, the preferred tree will be used. For requesters that do not support multiple trees, if the tree name is specified (a NULL string is not returned to the eDirectory libraries) and if the tree name is different from the preferred tree, an error will be returned.

To make use of the connection reference, a connection handle must be opened using the connection reference.

NCP Calls

None