NWLoginAsVolumeAuditor(3nw)


NWLoginAsVolumeAuditor -- enables auditor access on a specified volume

Synopsis

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
   

NWCCODE N_API NWLoginAsVolumeAuditor (NWCONN_HANDLE conn, nuint32 volumeNumber, nuint8 N_FAR * auditKey, nuint8 N_FAR * password);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

volumeNumber
(IN) Specifies the volume number on the NetWare server.

auditKey
(IN/OUT) Points to a 40-byte array.

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

Return values

0x0000
SUCCESSFUL

0x8801
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

Notices

NWLoginAsVolumeAuditor must be called before any auditing functions can be done.

auditKey is initialized and set up for future auditing API calls; auditKey must be allocated by the program.

Only a level one password is authenticated with NWLoginAsVolumeAuditor.

If auditing has not been initialized on the volume, call NWLoginAsVolumeAuditor and ``Auditing Not Enabled'' will be returned. Then call NWEnableAuditingOnVolume.

After calling NWEnableAuditingOnVolume, call NWLoginAsVolumeAuditor again to give the user access to auditing.

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

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

Services

Auditing

NCP calls

0x2222 88 03
Add Auditor Access

0x2222 88 19
Get Auditing Flags

References

NWLogoutAsVolumeAuditor(3nw), NWCheckAuditAccess(3nw), NWDSLoginAsContainerAuditor(3nw), NWInitAuditLevelTwoPassword(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.