NWADGetFileList(3nw)


NWADGetFileList -- returns the file list

Synopsis

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
   

N_EXTERN_LIBRARY NWRCODE NWADGetFileList (NWCONN_HANDLE conn, nuint32 auditIDType, nuint32 auditID, nptr auditHandle, pNWAuditFileList fileList);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

auditIDType
(IN) Specifies the type of object to change:

AUDIT_ID_IS_VOLUME
AUDIT_ID_IS_TRUSTED
AUDIT_ID_IS_CONTAINER

auditID
(IN) Specifies the value of the object type to change:

0 AUDIT_ID_IS_VOLUME indicating the audit ID represents a volume
1 AUDIT_ID_IS_CONTAINER indicating the audit ID represents a DS container
2 AUDIT_ID_IS_TRUSTED indicating the audit ID represents a Trusted NetWare type

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

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8983
Auditing Hardware Error

0x8984
Auditing Not Supported

0x8997
Auditing Not Enabled

0x8998
VOLUME_DOES_NOT_EXIST

0x89DE
PASSWORD_HAS_EXPIRED_NO_GRACE

Notices

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 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.

Services

Auditing

NCP calls

0x2222 88 23 Return Audit File List
0x2222 104 222 Return Audit File List

References

NWADOpen(3nw), NWADCloseRecordFile(3nw), NWADResetFile(3nw), NWADReadRecord(3nw), NWADOpenRecordFile(3nw),


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.