NWADChangeObjectProperty

Adds or removes the audit property for a user on a specified volume or container

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  NWADChangeObjectProperty  ( 
      NWCONN_HANDLE   conn,  
      nuint32         auditIDType,  
      nuint32         auditID,  
      nptr            auditHandle,  
      nuint32         objectID,  
      nuint8          auditFlag); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADChangeObjectProperty 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32; 
      auditHandle : nptr; 
      objectID : nuint32; 
      auditFlag : nuint8                       
   ) : 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.
objectID
(IN) Specifies the object ID number on which to change the audit property. If the object to be changed is a volume, objectID specifies the user ID; it specifies the NDS object number if an NDS object is to be changed.
auditFlag
(IN) Specifies whether the object will be audited: 1 = the object will be audited; 0 = the object will not be audited.

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

NWADChangeObjectProperty requires a second-level password when enabled.

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

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