Syntax

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
    
   N_EXTERN_LIBRARY (NWRCODE) NWADWriteBitMap  ( 
      NWCONN_HANDLE         conn,  
      nuint32               volumeID,  
      nptr                  auditHandle,  
      NWAuditBitMap  N_FAR  *buffer); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADWriteBitMap 
     (conn : NWCONN_HANDLE; 
      auditID : nuint32;                          
      auditHandle : nptr; 
      Var buffer : NWAuditBitMap 
   ) : NWRCODE; 
   
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

auditID

(IN) Specifies the number of the audited volume.

auditHandle

(IN) Points to the auditHandle allocated by NWADOpen.

buffer

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

Return Values

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

Remarks

NWADWriteBitMap requires a second level password when enabled.

This constant defines the number of bits in the event bitmap for volumes:

   NW_AUDIT_NUMBER_EVENT_BITS = 512
   

The buffer is a 512-bit stream. If a bit is set to one (1), the corresponding item found in auditBitMapIDs (nwaudit.h) is being audited.For a list of event bits, see Event Bits Tables.

If auditing is not enabled, NO_DISK_LEFT_FOR_SPOOL_FILE is returned; if auditing is not supported, NO_CREATE_PRIVILEGES is returned.

If auditIDType is set to AUDIT_ID_IS_VOLUME to indicate volume auditing, NWGetVolumeNumber can be called to get the volume number of the audit file object.

If auditIDType is set to AUDIT_ID_IS_CONTAINER to indicate container auditing, NWDSAuditGetObjectID can be called to get the Directory Service object ID of the audit file object.

NCP Calls

• 0x2222 88 16 Write Auditing Bit Map

See Also

NWADLogin, NWADOpen, NWADWriteConfigHeader, NWADReadBitMap, NWADReadConfigHeader, NWADInitLevelTwoPassword