Syntax

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
    
   N_EXTERN_LIBRARY NWRCODE  NWADReadBitMap  ( 
      NWCONN_HANDLE         conn,  
      nuint32               volumeID,  
      NWAuditBitMap N_FAR  *buffer,  
      nuint16               bufferSize); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADReadBitMap 
     (conn : NWCONN_HANDLE; 
      auditID : nuint32;                          
      Var buffer : NWAuditBitMap; 
      bufferSize : nuint16 
   ) : NWRCODE; 
   
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

auditID

(IN) Specifies the number of the audited volume.

buffer

(OUT) Points to NWAuditBitMap defining what is being audited.

bufferSize

(IN) Specifies the size of NWAuditBitMap expected. The entire bitmap needs to be received at once.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

NWAuditMap is a 512-bit stream. If a bit is set to one (1), the corresponding item found in auditBitMapIDs enumeration is being audited.

NWAuditBitMap may also be read by calling NWReadAuditConfigHeader.

When a bit in auditBitMapID is set to one, it generates an event and saves it in the audit file. The following table defines the set bits:

auditBitMapID lists the bits defined by the event bitmap in the audit file configuration header. The first 32 bits are reserved for NDS for container auditing. For a list of event bits, see Event Bits Tables.

NCP Calls

• 0x2222 88 10 Read Audit Bit Map

See Also

NWADReadConfigHeader, NWADWriteBitMap, NWADLogin