NWDSVerifyPwdEx

Verifies the password of an object. Supports international and extended characters in passwords. NWDSVerifyPwdEx was not implemented in the old NLMs so you might not find it if you are using an old netnlm32.

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)  NWDSVerifyPwdEx  ( 
     NWDSContextHandle   context,    
     pnstr8              objectName,
     nuint32             pwdFormat,  
     nptr                pwd);

Pascal

  uses netwin32 
   
  Function NWDSVerifyPwdEx 
    (context : NWDSContextHandle; 
     objectName : pnstr8;
     pwdFormat : nuint32; 
     pwd : nptr 
  ) : NWDSCCODE;

Parameters

context

(IN) Specifies the handle to the name context structure.

objectName

(IN) Points to the object name (under the context) of the object to verify.

pwdFormat

(IN) Specifies the format of the password data. Select from the following:

Password Format	Description
PWD_UNICODE_STRING	Allows any unicode string to be used as a password.
PWD_UTF8_STRING	Allows any UTF8 string to be used as a password.
PWD_RAW_C_STRING	Allows any arbitrary NULL-terminated data to be used as a password. Passwords specified with this format are not interoperable with unicode and UTF8 passwords.

pwd

(IN) Points to the password for the object.

Return Values

0x0000 0000	SUCCESSFUL
nonzero value	Nonzero values indicate errors. See NDS Return Values.

Remarks

To call NWDSVerifyObjectPassword successfully, the current password of the object must be known. If no such password exists, password should point to a zero-length string. All strings used by NWDSVerifyObjectPassword are NULL-terminated. password can be any length and all characters are significant. Upper- and lowercase letters are distinct.

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.

NCP Calls

0x2222 104 02 Send eDirectory Fragmented Request/Reply