NWDSAuthenticateConn

Authenticates and licenses an established connection to a NetWare server.

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98, Windows 2000, Windows XP
Library:Cross-Platform NDS (NET*.*)
Service:NDS

Syntax

C

  #include <nwnet.h> 
  or 
  #include <nwdsasa.h> 
   
  N_EXTERN_LIBRARY (NWDSCCODE) NWDSAuthenticateConn  ( 
     NWDSContextHandle   context,  
     NWCONN_HANDLE       connHandle);

Pascal

  uses netwin32 
   
  Function NWDSAuthenticateConn 
    (context : NWDSContextHandle; 
     connHandle : NWCONN_HANDLE 
  ) : NWDSCCODE;

Parameters

context

(IN) Specifies the NDS context for the request.

connHandle

(IN) Specifies the connection handle to authenticate.

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

NWDSAuthenticateConn authenticates and licenses the connection using the identity established by calling NWDSLogin. An authenticated, licensed connection has access to eDirectory and the file system.

The context handle is used to indicate which tree (and hence which identity) 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.

If the specified connection is already authenticated, the function returns SUCCESSFUL and ends the call.

NCP Calls

See Also

NWDSOpenConnToNDSServer, NWCCOpenConnByName