NWDSOpenMonitoredConn(3nw)
NWDSOpenMonitoredConn --
establishes a monitored connection when NWDSLogin
Synopsis
#include <nwdsconn.h>
N_EXTERN_LIBRARY (NWDSCCODE) NWDSOpenMonitoredConn
(NWDSContextHandle context,
pNWCONN_HANDLE connHandle);
Description
The parameters are as follows:
- context
-
(IN) Specifies the Directory context for the request.
- connHandle
-
(OUT) Points to the connection handle.
Return values
- 0x0000
-
SUCCESSFUL
- Negative Value
-
Negative values indicate errors. For errors returned by Directory Services,
see ``Directory Services OS Errors'' (-001 to -255), ``Directory Services
Client Library Errors'' (-301 to -399), or ``Directory Services Agent in the
Server Errors'' (-601 to -699).
Notices
A monitored connection is set only if NWDSLogin has been called. For mulitple tree support, the tree name specified in the context handle is used to specify which
monitored connection to retrieve. If the underlying requester does not support
multiple NDS trees, the single monitored connection is retrieved. The user is responsible for
closing the connection handle.
Services
Connection (Directory Support)
NCP calls
None
References
NWDSGetMonitoredConnRef(3nw),
NWDSOpenConnToNDSServer(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.