Syntax

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

Pascal Syntax

   uses audwin32 
    
   Function NWADCheckAccess 
     (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.

Remarks

If zero (0) is returned, the user has auditor access and is currently logged in through NWADLogin.

If one (1) is returned, the user does not have auditor access.

In NetWare 4.11, you can only call NWADLogin once, which will set the auditor access on the server. If subsequent calls are made, an error will be returned.

The second level password is only supported under NetWare 4.1. NetWare 4.11 does not use second level passwords.

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 05 Change Auditor Access
• 0x2222 104 204 Directory Services Check Auditor Access

See Also

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