NWDSAuthenticate (obsolete 06/03)

Establishes an authenticated connection to a secured NetWare server using the unauthenticated connection and local data cached by calling NWDSLogin, but is now obsolete.

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)  NWDSAuthenticate  ( 
     NWCONN_HANDLE         conn,  
     nflag32               optionsFlag,  
     pNWDS_Session_Key_T   sessionKey);

Pascal

  uses netwin32 
   
  Function NWDSAuthenticate 
    (conn : NWCONN_HANDLE; 
     optionsFlag : nflag32; 
     sessionKey : pNWDS_Session_Key_T 
  ) : NWDSCCODE;

Parameters

conn: (IN) Specifies the client’s initial unauthenticated connection handle.
optionsFlag: (IN) Specifies reserved; pass in a zero (0).
sessionKey: (IN) Points to reserved; pass in NULL.

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values (–001 to –799).

Remarks

NWDSAuthenticate first checks to see if the specified connection is authenticated. If the connection is authenticated, NWDSAuthenticate will return SUCCESSFUL and end the call.

Use NWDSAuthenticateConn or NWDSAuthenticateConnEx in place of this function.

NCP Calls

0x2222 23 17 Get File Server Information
0x2222 23 22 Get Station’s Logged Info (old)
0x2222 23 28 Get Station’s Logged Info
0x2222 104 01 Ping for eDirectory NCP
0x2222 104 02 Send eDirectory Fragmented Request/Reply