NWDSOpenConnToNDSServer(3nw)
NWDSOpenConnToNDSServer --
locates a connection to a specific server
Synopsis
#include <nwdsconn.h>
NWDSCCODE N_API NWDSOpenConnToNDSServer
(NWDSContextHandle context,
pnstr8 serverName,
pNWCONN_HANDLE connHandle);
Description
The parameters are as follows:
- context
-
(IN) Specifies the Directory context for the request.
- serverName
-
(IN) Points to the server to receive 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
NWDSOpenConnToNDSServer allows you to locate a connection to a
specific server that is specified by an NDS style name. The
serverName is resolved using NDS and a connection is established, or, if the workstation already has a connection, the connection handle is returned.
Services
Connection (Directory Support)
NCP calls
None
References
NWDSAuthenticateConn(3nw),
NWDSOpenMonitoredConn(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.