Syntax

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
    
   N_EXTERN_LIBRARY NWRCODE  NWADLogin  ( 
      NWCONN_HANDLE   conn,  
      nuint32         auditIDType,  
      nuint32         auditID,  
      nptr            auditHandle,  
      pnuint8         password); 
   
   

Pascal Syntax

   uses audwin32 
    
   Function NWADLogin 
     (conn : NWCONN_HANDLE; 
      auditIDType : nuint32; 
      auditID : nuint32; 
      auditHandle : nptr; 
      Var password : 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.

password

(IN) Points to the address of a NULL-terminated character string containing the password.

Return Values

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

Remarks

Calling NWADLogin is the first step to any auditing function.

auditHandle is initialized and setup for future auditing API calls; auditHandle must be allocated by the program.

Only a level one password is authenticated with NWADLogin.

If auditing has never been initialized on the Container, call NWADLogin first; AUDITING_NOT_ENABLED will be returned. Then, call NWADEnable.

If the user is not SUPERVISOR equivalent, NWADEnable will fail the first time it is called.

After calling NWADEnable successfully, the user must log in again by calling NWADLogin to have access to auditing.

Once auditing has been enabled, the user does not have to be SUPERVISOR equivalent, but must know the auditor password.

NetWare 4.11 does not use a password unless a password has been set by calling NWADSetPassword. Call NWADGetStatus to determine if a password has been set.

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 03 Add Auditor Access
• 0x2222 88 19 Get Auditing Flags
• 0x2222 104 202 Directory Services Add Auditor Access
• 0x2222 104 216 Get Auditing Flags

See Also

NWADCheckAccess, NWADEnable, NWADGetStatus, NWADInitLevelTwoPassword, NWADLogout, NWADOpen, NWDSAuditGetObjectID (obsolete 06/03) (NDS Core Services), NWGetVolumeNumber (Volume Management)