NWADIsObjectAudited

Checks to see if specified object or user is being audited

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  NWADIsObjectAudited  ( 
      NWCONN_HANDLE   conn,  
      nuint32         auditIDType,  
      nuint32         auditID,  
      nuint32         userObjectID); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADIsObjectAudited 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32; 
      userObjectID : 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.
userObjectID
(IN) Specifies the object ID to be checked if it is being audited.

Return Values

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

0x0000

SUCCESSFUL-User is not being audited.

0x0001

SUCCESSFUL-User is being audited.

Remarks

NWADIsObjectAudited returns 0x0000 if the user is not being audited and 0x0001 if the user is being audited.

userObjectID must be byte-swapped to the same format in which the server stores it.

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

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