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.