Performs all authentication operations needed to establish a client’s connection to the network and to the network’s authentication service. Supports international and extended characters in passwords.
#include <nwnet.h>
or
#include <nwdsasa.h>
N_EXTERN_LIBRARY (NWDSCCODE) NWDSLoginEx (
NWDSContextHandle context,
pnstr8 objectName,
nuint32 pwdFormat,
nptr pwd);
uses netwin32
Function NWDSLoginEx
(context : NWDSContextHandle;
objectName : pnstr8;
pwdFormat : nuint32;
pwd : nptr
) : NWDSCCODE;
(IN) Specifies the NDS context for the request.
(IN) Points to the name of the object logging into the network.
(IN) Specifies the format of the password data. Select from the following:
(IN) Points to the client’s password.
|
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:The PWD_RAW_C_STRING password format allows any arbitrary NULL-terminiated data to be used as a password. Passwords specified with this format are not interoperable with unicode and UTF8 passwords.