NWADRestartVolumeAuditing

Restarts auditing for volumes only

Local Servers:blocking
Remote Servers:blocking
NetWare Server:4.1 and above
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform Auditing (AUD*.*)
Service:Auditing

Syntax

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
    
   N_EXTERN_LIBRARY NWRCODE  NWADRestartVolumeAuditing  ( 
      NWCONN_HANDLE   conn,  
      nuint32         auditIDType,  
      nuint32         auditID); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADRestartVolumeAuditing 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32 
   ) : NWRCODE; 
   
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.
auditIDType
(IN) Specifies the type of the object to be audited.
  • 0 AUDIT_ID_IS_VOLUME indicates volume auditing
  • 1 AUDIT_ID_IS_CONTAINER indicates container auditing
auditID
(IN) Specifies the identification of the object to be audited.

Return Values

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

0x0000

SUCCESSFUL

Remarks

NWADRestartVolumeAuditing is for NetWare 4.11 only and is not supported on NetWare 4.1.

NWADRestartVolumeAuditing should be called when the history file has reached the size limit or a volume is full. The auditor (not a password auditor) should access the volume and correct the situation, and then call NWADRestartVolumeAuditing to restart auditing on the volume. Other users may then access the volume.

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

See Also

NWDSAuditGetObjectID (obsolete 06/03) (NDS Core Services), NWGetVolumeNumber (Volume Management)