NWDSSetMonitoredConnection (obsolete 06/03)

Tracks the connection, but is now obsolete.

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 <nwndscon.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE)  NWDSSetMonitoredConnection 
    (NWCONN_HANDLE   connHandle);

Pascal

  uses netwin32 
   
  Function NWDSSetMonitoredConnection 
    (connHandle : NWCONN_HANDLE 
  ) : NWCCODE;

Parameters

connHandle: (IN) Specifies the connection handle of the desired connection.

Return Values

These are common return values; see NDS Return Values for more information.

0x0000 0000	SUCCESSFUL
nonzero value	UNSUCCESSFUL

Remarks

When a user logs in to the eDirectory tree, several attributes are created and maintained on the NetWare server where the user’s object resides. If the connection is removed, these attributes are destroyed. To prevent these attributes from being destroyed, call NWDSSetMonitoredConnection to track the connection. If the connection is destroyed, several eDirectory functions such as NWDSWhoAmI do not return valid information.

No replacement is needed for this function as monitored connections are managed autmoatically by the client software.

NCP Calls

None