NWADCheckAccess(3nw)


NWADCheckAccess -- checks to see if the auditor has auditor access

Synopsis

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

N_EXTERN_LIBRARY NWRCODE NWADCheckAccess (NWCONN_HANDLE conn, nuint32 auditIDType, nuint32 auditID);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

auditIDType
(IN) Specifies the type of object to check:

AUDIT_ID_IS_VOLUME
AUDIT_ID_IS_TRUSTED
AUDIT_ID_IS_CONTAINER

auditID
(IN) Specifies the value of the object type to check:

0 AUDIT_ID_IS_VOLUME indicating the audit ID represents a volume
1 AUDIT_ID_IS_CONTAINER indicating the audit ID represents a DS container
2 AUDIT_ID_IS_TRUSTED indicating the audit ID represents a Trusted NetWare type

Return values

0x0000
SUCCESSFUL

0x0001
No Audit Access

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

If zero (0) is returned, the user has auditor access and is currently logged in through NWADLogin.

If one (1) is returned, the user does not have auditor access.

In trusted NetWare, you can only call NWADLogin once, which will set the auditor access on the file server. If subsequent calls are made, an error will be returned.

The second level password is only supported under NetWare 4.1. Trusted NetWare does not use second level passwords.

Services

Auditing

NCP calls

0x2222 88 05 Change Auditor Access
0x2222 104 204 Directory Services Check Auditor Access

References

NWADCheckLevelTwoAccess(3nw), NWADLogin(3nw),


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.