NWADEnable(3nw)
NWADEnable --
enables auditing on the specified Directory Services container or volume
Synopsis
#include <nwaudit.h>
or
#include <nwnet.h>
N_EXTERN_LIBRARY NWRCODE NWADEnable
(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
Notices
If auditing has never been initialized on the volume, call NWADLogin first; 0x8997 will be returned. Then, call NWADEnable.
If the user is not SUPERVISOR equivalent, NWADEnable will fail the first time it is called.
After NWADEnable has been called successfully, the user must log in again by calling NWADLogin to have access to auditing.
For trusted NetWare, a different approach must be followed to enable auditing. You must log into NetWare through Directory Services and have enough rights to create objects and
add attributes. You may then add auditor access by adding the AFO attributes to a user object and assigning it to a volume or container. This user can then enable auditing on the
volume or container.
A password user on trusted NetWare cannot enable auditing.
Services
Auditing
NCP calls
0x2222 104 207 Directory Services Enable Container Volume Auditing
References
NWADDisable(3nw),
NWADOpen(3nw),
NWADLogin(3nw),
NWADInitLevelTwoPassword(3nw),
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.