NWDSAuthenticateConn(3nw)


NWDSAuthenticateConn -- establishes an authenticated connection to a secured NetWare server

Synopsis

   #include <nwdsas.h> 
   

N_EXTERN_LIBRARY (NWDSCCODE) NWDSAuthenticateConn (NWDSContextHandle context, pNWCONN_HANDLE connHandle);

Description

The parameters are as follows:

context
(IN) Specifies the Directory context for the request.

connHandle
(IN) Points to the connection handle to authenticate.

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

NWDSAuthenticateConn establishes an authenticated connection to a secured NetWare server using the unauthenticated connection and the identity, established by calling NWDSLogin, of the object derived from the context handle.

The context handle is used to indicate which tree (and hence which identify) to use in authenticating the connection handle. If the underlying requester does not support multiple tree authentications, the tree value of the context handle is ignored.

Services

Connection (Directory Support)

NCP calls

None

References

NWDSOpenConnToNDSServer(3nw), NWDSOpenMonitoredConn(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.