NWDSGetMonitoredConnRef(3nw)
NWDSGetMonitoredConnRef --
retrieves a monitored connection reference
Synopsis
#include <nwdsconn.h>
N_EXTERN_LIBRARY (NWDSCCODE) NWDSGetMonitoredConn
(NWDSContextHandle context,
pnuint32 connRef);
Description
The parameters are as follows:
- context
-
(IN) Specifies the Directory context for the request.
- connRef
-
(OUT) Points to the connection reference.
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 reference 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 reference to retrieve. If the underlying requester
does not support multiple NDS trees, the single monitored connection reference
is retrieved.
In order to make use of the connection reference, a connection handle must be opened using the connection reference.
Services
Connection (Directory Support)
NCP calls
None
References
NWDSOpenMonitoredConn(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.