NWADGetStatus(3nw)
NWADGetStatus --
returns the audit information and status of the specified volume or container
Synopsis
#include <nwaudit.h>
or
#include <nwnet.h>
N_EXTERN_LIBRARY NWRCODE NWADGetStatus
(NWCONN_HANDLE conn,
nuint32 auditIDType,
nuint32 auditID,
pNWAuditStatus auditStatus,
nuint16 bufferSize);
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
- auditStatus
-
(OUT) Points to NWAuditStatus containing fields for the information to be returned.
- bufferSize
-
(IN) Specifies the size of the memory space.
Return values
-
0x0000
SUCCESSFUL
- 0x8801
-
INVALID_CONNECTION
- 0x8983
-
Auditing Hardware Error
- 0x8984
-
Auditing Not Supported
- 0x8998
-
VOLUME_DOES_NOT_EXIST
- 0x89F2
-
Audit Password Enabled
Notices
The historyRecordCount
of the NWAuditStatus structure will remain zero (0) because the history records are kept inside the audit file.
For trusted NetWare, if NWADGetStatus returns 0x89F2, the user is not allowed auditor access. However, the NWAuditStatus structure will still be filled. You
should check the auditFlags
field for a value of one (1) which indicates passwords are allowed. If the value is one (1), NWADLogin can then be called with a
valid password. Call NWADCheckAccess to set the audit access bit on the server side. Subsequent calls will then be enabled for password users on trusted NetWare.
Services
Auditing
NCP calls
0x2222 88 01 Return Volume Audit Status
0x2222 104 200 Directory Services Return Volume Audit Status
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.