Syntax

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

Pascal Syntax

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

fileList

(OUT) Points to the structure NWAuditFileList containing the size, date, and time for the past 16 elements.

Return Values

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

Remarks

NWADGetFileList returns a list of the dates, times, and sizes of old audit files. The list contains a total of up to 16 (0-15) files that can be added to the list by calling NWADResetFile.

If the fileCreateDateTime field of NWAuditFileList is not zero, the fileSize field is valid.

The file number zero (0) indicates the current history file; file numbers 1-15 indicate old history files. The number of old files to keep is indicated by bufferSize in NWADReadConfigHeader and NWADWriteConfigHeader and has a maximum of 15 files.

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 23 Return Audit File List
• 0x2222 104 222 Return Audit File List

See Also

NWADCloseRecordFile, NWADOpen, NWADOpenRecordFile, NWADReadRecord, NWADResetFile, NWDSAuditGetObjectID (obsolete 06/03) (NDS Core Services), NWGetVolumeNumber (Volume Management)