Performs all authentication operations needed to establish a client’s connection to the network and to the network’s authentication service. Does not support international or extended characters in passwords.
#include <nwnet.h> or #include <nwdsasa.h> N_EXTERN_LIBRARY (NWDSCCODE) NWDSLogin ( NWDSContextHandle context, nflag32 optionsFlag, pnstr8 objectName, pnstr8 password, nuint32 validityPeriod);
uses netwin32 Function NWDSLogin (context : NWDSContextHandle; optionsFlag : nflag32; objectName : pnstr8; password : pnstr8; validityPeriod : nuint32 ) : NWDSCCODE;
(IN) Specifies the NDS context for the request.
Reserved; pass in zero.
(IN) Points to the name of the object logging into the network.
(IN) Points to the client’s password.
Reserved for future use to indicate, in seconds, the period during which authentication will be valid with other servers. Pass in zero (0).
0x0000 0000 |
SUCCESSFUL |
nonzero value |
Nonzero values indicate errors. See |
NWDSLogin caches authentication information locally to be used by other functions and in background authentication to additional services.
The password parameter points to the client’s current password in clear text. If there is no password for the client, its value should point to a zero-length string ("").
If an application has a local copy of any password value, the value should be erased as soon as possible to prevent compromising the security of the password.
Until an authenticated connection is established, the client can access only eDirectory information classified as public.
NOTE:NWDSLoginEx supports internation and extended characters in passwords and is recommended in place of NWDSLogin.