Syntax

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
    
   N_EXTERN_LIBRARY NWRCODE  NWADResetFile  ( 
      NWCONN_HANDLE   conn,  
      nuint32         auditIDType,  
      nuint32         auditID,  
      nptr            auditHandle); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADResetFile 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32; 
      auditHandle : nptr 
   ) : 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.

Return Values

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

Remarks

The original file is saved to the OLD file and a new audit file is set up to store audit events.

NWADResetFile requires a level two password when enabled.

The name of the data file is containerID.DAF. When the file is reset, it is renamed to containID.OAF. These files are hidden, and reside in a hidden directory called _NetWare on a NetWare server having a writable replica of the container probably where the object resides.

NWADResetFile is only supported on NetWare 4.1; NetWare 4.11 does not support NWADResetFile.

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 14 Reset Audit File
• 0x2222 104 212 Directory Services Reset Audit File

See Also

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