NWDSAuthenticateConnEx

Authenticates, but does not license, 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) NWDSAuthenticateConnEx  ( 
     NWDSContextHandle   context,  
     NWCONN_HANDLE       connHandle); 
  

Pascal

  uses netwin32 
   
  Function NWDSAuthenticateConnEx 
    (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

NWDSAuthenticateConnEx authenticates the connection using the identity, established by calling NWDSLogin, of the object derived from the context handle. The connection is authenticated not licensed. Such connections have access to eDirectory; to access the file system the connection must be licensed.

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.

To license an authenticated connection, call NWCCLicenseConn.

NCP Calls

See Also

NWDSOpenConnToNDSServer, NWDSOpenMonitoredConn, NWCCOpenConnByName, NWCCLicenseConn