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.