NWDSVerifyObjectPassword

Verifies the password of an object. Does not support international or extended characters in passwords.

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)  NWDSVerifyObjectPassword  ( 
     NWDSContextHandle   context,  
     nflag32             optionsFlag,  
     pnstr8              objectName,  
     pnstr8              password); 
  

Pascal

  uses netwin32 
   
  Function NWDSVerifyObjectPassword 
    (context : NWDSContextHandle; 
     optionsFlag : nflag32; 
     objectName : pnstr8; 
     password : pnstr8 
  ) : NWDSCCODE;
  

Parameters

context

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

optionsFlag

(IN) Reserved; pass in zero.

objectName

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

password

(IN) Points to the clear-text password for the object.

Return Values

0x0000 0000

SUCCESSFUL

nonzero value

Nonzero values indicate errors. See NDS Return Values (–001 to –799).

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.

NOTE:NWDSVerifyPwdEx supports international and extended characters and is recommended in place of NWDSVerifyObjectPassword.

NCP Calls

See Also

NWDSGenerateObjectKeyPair, NWDSLogin, NWDSChangeObjectPassword