NWReadAuditingFileRecord(3nw)


NWReadAuditingFileRecord -- reads audit file on volume

Synopsis

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

NWCCODE N_API NWReadAuditingFileRecord (nuint32 volumeContainerID, nint16 fileCode, void N_FAR * buffer, nuint16 N_FAR * bufferSize, nuint16 maxSize, nuint8 N_FAR * eofFlag);

Description

The parameters are as follows:

volumeContainerID
(IN) Specifies the volume number on the NetWare server or the container ID for Directory Services.

fileCode
(IN) Specifies the file type.

buffer
(OUT) Points to the user area allocated to save the data.

bufferSize
(IN) Points to the variable specifying the size of the data returned in the buffer.

maxSize
(IN) Specifies the maximum size of the buffer allocated by the user. A minimum of 512 bytes should be allocated.

eofFlag
(OUT) Points to the end of file flag. When the last record is read, it is set to a non-zero value.

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

Directory Services does not keep an audit history; events are saved in the audit file. NWReadAuditingFileRecord returns events in single complete records to the buffer until the end of the file.

The audit file is compressed; it needs to be read sequentially by NWReadAuditingFileRecord, which decompresses the file.

NWInitAuditFileRead must be called before calling NWReadAuditingFileRecord.

File types for fileCode follow:

0
NW_AUDIT_FILE_CODE

1
NW_AUDIT_HISTORY_FILE_CODE

2
NW_AUDIT_OLD_FILE_CODE

Services

Auditing

NCP calls

0x2222 88 12 Read Auditing File
0x2222 104 21 Read Auditing Files

 
 ------------------------------------------ 
| 0x2222|  88 |  12|  Read Auditing File  | 
|-------|-----|----|----------------------| 
| 0x2222|  104|  21|  Read Auditing Files | 
|-------|-----|----|----------------------| 

References

NWInitAuditFileRead(3nw), NWLoginAsVolumeAuditor(3nw), NWResetAuditHistoryFile(3nw), NWResetAuditingFile(3nw), NWDSResetAuditingFile(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.