Syntax

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
    
   N_EXTERN_LIBRARY NWRCODE  NWADChangePassword  ( 
      NWCONN_HANDLE   conn,  
      nuint32         auditIDType,  
      nuint32         auditID,  
      nptr            auditHandle,  
      pnuint8         newPassword,  
      nuint8          level); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADChangePassword 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32; 
      auditHandle : nptr; 
      Var newPassword : nuint8; 
      level : nuint8 
   ) : NWRCODE; 
   
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

auditIDType

(IN) Specifies the type of the object to be audited.

• 0 AUDIT_ID_IS_VOLUME indicates volume auditing
• 1 AUDIT_ID_IS_CONTAINER indicates container auditing

auditID

(IN) Specifies the identification of the object to be audited.

auditHandle

(IN) Points to the auditHandle allocated by NWADOpen.

newPassword

(IN) Points to a NULL-terminated character string containing the new password.

level

(IN) Specifies which password to change; for example, 2 = level two password.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

If NWADChangePassword fails, the original password is still valid.

NWADChangePassword is only supported for NetWare 4.1 and above. To call NWADChangePassword under NetWare 4.11, a password has to be set and the user who set the password cannot be a password user.

If auditIDType is set to AUDIT_ID_IS_VOLUME to indicate volume auditing, NWGetVolumeNumber can be called to get the volume number of the audit file object.

If auditIDType is set to AUDIT_ID_IS_CONTAINER to indicate container auditing, NWDSAuditGetObjectID can be called to get the Directory Service object ID of the audit file object.

NCP Calls

• 0x2222 88 04 Change Auditor Volume Password
• 0x2222 88 18 Change Audit Level Two Volume Password
• 0x2222 88 19 Get Auditing Flags
• 0x2222 104 203 Directory Services Change Audit Password
• 0x2222 104 215 Directory Services Change Audit Level Two Password
• 0x2222 104 216 Get Auditing Flags

See Also

NWADLogin, NWADOpen, NWDSAuditGetObjectID (obsolete 06/03) (NDS Core Services), NWGetVolumeNumber (Volume Management)