NWADLogin(3nw)
NWADLogin --
enables auditor access on a specified container or volume
Synopsis
#include <nwaudit.h>
or
#include <nwnet.h>
N_EXTERN_LIBRARY NWRCODE NWADLogin
(NWCONN_HANDLE conn,
nuint32 auditIDType,
nuint32 auditID,
nptr auditHandle,
pnuint8 password);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the NetWare server connection handle.
- auditIDType
-
(IN) Specifies the type of object to change:
AUDIT_ID_IS_VOLUME
AUDIT_ID_IS_TRUSTED
AUDIT_ID_IS_CONTAINER
- auditID
-
(IN) Specifies the value of the object type to change:
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
- 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
- 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
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.
Trusted NetWare does not use a password unless a password has been set by calling NWADSetPassword. Call NWADGetStatus to determine if a password has been set.
Services
Auditing
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
References
NWADEnable(3nw),
NWADGetStatus(3nw),
NWADOpen(3nw),
NWADCheckAccess(3nw),
NWADInitLevelTwoPassword(3nw),
NWADLogout(3nw),
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.