NWDSLoginAsContainerAuditor(3nw)


NWDSLoginAsContainerAuditor -- enables auditor access on a specified container

Synopsis

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

NWCCODE N_API NWDSLoginAsContainerAuditor (NWCONN_HANDLE conn, nuint32 containerID, nuint8 N_FAR * key, nuint8 N_FAR * password);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

containerID
(IN) Specifies the Directory Services ID.

key
(IN) Points to a 40-byte array containing the audit key.

password
(IN) Points to the address of 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

0x89DE
PASSWORD_HAS_EXPIRED_NO_GRACE

Notices

Calling NWDSLoginAsContainerAuditor is the first step to any auditing function.

auditKey is initialized and setup for future auditing API calls; auditKey must be allocated by the program. Only a level one password is authenticated with NWDSLoginAsContainerAuditor.

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

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

After calling NWDSEnableAuditingOnContainer successfully, the user must log in again by calling NWDSLoginAsContainerAuditor 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.

Services

Auditing (Directory Support)

NCP calls

0x2222 104 202
Directory Services Add Auditor Access

0x2222 104 216
Get Auditing Flags

References

NWLoginAsVolumeAuditor(3nw), NWDSCheckAuditAccess(3nw), NWDSAuditGetObjectID(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.