NWInitAuditFileRead(3nw)


NWInitAuditFileRead -- initializes and sets up all file pointers for auditing event file reads

Synopsis

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

NWCCODE N_API NWInitAuditFileRead (NWCONN_HANDLE conn, nuint32 volumeContainerID, nint16 fileCode, nint16 DSFlag);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

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

fileCode
(IN) Specifies the file to reset and setup for reading.

DSFlag
(IN) Specifies the volume container or volume number: 1 = volume container (Directory Services); 0 = volume number

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

The following definitions comprise three possible file types:

   #define NW_AUDIT_FILE_CODE           0 
   #define NW_AUDIT_HISTORY_FILE_CODE   1 
   #define NW_AUDIT_OLD_FILE_CODE       2 

Audit History file does not exist for directory services. Audit History comments are saved in Audit file. (Audit file contains audit events, and Audit History file contains records of events while logged in as auditor.)

Services

Auditing

NCP calls

0x2222 88 1
Get Volume Audit Status

0x2222 104 200
Get Container Audit Status

References

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