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.