NWADResetFile(3nw)
NWADResetFile --
resets the audit file on a specified container or volume
Synopsis
#include <nwaudit.h>
or
#include <nwnet.h>
N_EXTERN_LIBRARY NWRCODE NWADResetFile
(NWCONN_HANDLE conn,
nuint32 auditIDType,
nuint32 auditID,
nptr auditHandle);
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.
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.
NWADResetFile 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.
NWADResetFile is only supported on NetWare 4.1; trusted NetWare does not support NWADResetFile.
Services
Auditing
NCP calls
0x2222 88 14 Reset Audit File
0x2222 104 212 Directory Services Reset Audit File
References
NWADLogin(3nw),
NWADInitLevelTwoPassword(3nw),
NWADOpen(3nw),
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.