NWADOpen

Allocates auditHandle for use in other Auditing functions

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 NWADOpen ( 
      NWCONN_HANDLE     conn,  
      nuint32           auditIDType,  
      nuint32           auditID,  
      pnptr             auditHandle,  
      pNWADOpenStatus   openStatus); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADOpen 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32; 
      Var auditHandle : nptr;                        
      openStatus : pNWADOpenStatus 
   ) : NWRCODE; 
   
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.
auditIDType
(IN) Specifies the type of the auditID parameter.
  • 0 AUDIT_ID_IS_VOLUME indicates volume auditing
  • 1 AUDIT_ID_IS_CONTAINER indicates container auditing
auditID
(IN) Specifies the volume number for volume auditing or the object ID of the DS Audit File Object for container auditing.
auditHandle
(OUT) Points to the auditHandle allocated by NWADOpen.
openStatus
(OUT) Points to the NWADOpenStatus structure containing the file status.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8983

Auditing Hardware Error

0x8984

Auditing Not Supported

0x8997

Auditing Not Enabled

0x8998

VOLUME_DOES_NOT_EXIST

0x89DE

PASSWORD_HAS_EXPIRED_NO_GRACE

Remarks

NWGetVolumeNumber can be called to query the volume number.

NWDSAuditGetObjectID can be called to query the object ID.

See Also

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