NWDSResetAuditingFile(3nw)


NWDSResetAuditingFile -- resets the audit file on a specified container

Synopsis

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

NWCCODE N_API NWDSResetAuditingFile (NWCONN_HANDLE conn, nuint32 containerID, nuint8 N_FAR * key);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

containerID
(IN) Specifies the Directory services container ID.

key
(IN) Points to a 40-byte array containing the audit key.

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 original file is saved to the OLD file and a new audit file is set up to store audit events.

NWDSResetAuditingFile 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 writeable replica of the container probably where the object resides.

Services

Auditing (Directory Support)

NCP calls

0x2222 104 212
Diirectory Services Reset Audit File

References

NWDSLoginAsContainerAuditor(3nw), NWInitAuditLevelTwoPassword(3nw), NWReadAuditingFileRecord(3nw), NWResetAuditingFile(3nw), NWInitAuditFileRead(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.