NWADReadConfigHeader(3nw)


NWADReadConfigHeader -- returns configuration header from auditing file

Synopsis

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
   

N_EXTERN_LIBRARY NWRCODE NWADReadConfigHeader (NWCONN_HANDLE conn, nuint32 auditIDType, nuint32 auditID, nptr buffer, 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 indicates the audit ID represents a volume
1 AUDIT_ID_IS_CONTAINER indicates the audit ID represents a DS container
2 AUDIT_ID_IS_TRUSTED indicates the audit ID represents a Trusted NetWare type

 
 0   AUDIT_ID_IS_VOLUME      indicates the audit 
                             ID represents a 
                             volume 
 1   AUDIT_ID_IS_CONTAINER   indicates the audit 
                             ID represents a DS 
                             container 
 2   AUDIT_ID_IS_TRUSTED     indicates the audit 
                             ID represents a 
                             Trusted NetWare 
                             type 

buffer
(OUT) Points to an array in which data is saved.

bufferSize
(IN) Specifies the size of the configuration header for saving data.

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

volumeAuditEventBitMap in NWConfigHeader may also be read by calling NWReadAuditingBitMap.

Services

Auditing

NCP calls

0x2222 88 11
Read Audit Config Hdr

0x2222 104 209
Directory Services Read Audit Configuration Header

References

NWADLogin(3nw), NWADReadBitMap(3nw), NWADWriteConfigHeader(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.