Syntax

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

Pascal Syntax

   uses audwin32 
    
   Function NWADEnable 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32; 
      auditHandle : nptr 
   ) : 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.

auditHandle

(IN) Points to the auditHandle allocated by NWADOpen.

Return Values

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

Remarks

If auditing has never been initialized on the volume, call NWADLogin first; 0x8997 will be returned. Then, call NWADEnable.

If the user is not SUPERVISOR equivalent, NWADEnable will fail the first time it is called.

After NWADEnable has been called successfully, the user must log in again by calling NWADLogin to have access to auditing.

For NetWare 4.11, a different approach must be followed to enable auditing. You must log into NetWare through NDS and have the necessary rights to create objects and add attributes. You may then add auditor access by adding the AFO attributes to a user object and assigning it to a volume or container. This user can then enable auditing on the volume or container.

A password user on NetWare 4.11 cannot enable auditing.

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 104 207 Directory Services Enable Container Volume Auditing

See Also

NWADDisable, NWADInitLevelTwoPassword, NWADLogin, NWADOpen, NWDSAuditGetObjectID (obsolete 06/03) (NDS Core Services), NWGetVolumeNumber (Volume Management)