Syntax

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
    
   N_EXTERN_LIBRARY NWRCODE  NWADGetStatus  ( 
      NWCONN_HANDLE    conn,  
      nuint32          auditIDType,  
      nuint32          auditID,  
      pNWAuditStatus   auditStatus,  
      nuint16          bufferSize); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADGetStatus 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32; 
      auditStatus : pNWAuditStatus; 
      bufferSize : nuint16 
   ) : 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.

auditStatus

(OUT) Points to NWAuditStatus containing fields for the information to be returned.

bufferSize

(IN) Specifies the size of the memory space.

Return Values

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

Remarks

The historyRecordCount of the NWAuditStatus structure will remain zero (0) because the history records are kept inside the audit file.

For NetWare 4.11, if NWADGetStatus returns 0x89F2, the user is not allowed auditor access. However, the NWAuditStatus structure will still be filled. You should check the auditingFlags field for a value of one (1) which indicates passwords are allowed. If the value is one (1), NWADLogin can then be called with a valid password. Call NWADCheckAccess to set the audit access bit on the server side. Subsequent calls will then be enabled for password users on NetWare 4.11.

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 01 Return Volume Audit Status
• 0x2222 104 200 Directory Services Return Volume Audit Status

See Also

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