Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-33
USER_AUTHENTICATE_ Procedure
status output
INT .EXT:ref:1
returns a value providing more information when
error is 0, 48, or 70. status
values are described in the following three tables:
Values returned for
error = 0 (no error):
Values returned for
error = 48 (security violation):
status Description
0 No status.
8 Password is valid but it is about to expire. Caller should return
caution message.
status Description
1 User does not exist or password is incorrect.
2
Cannot authenticate with user ID because (1)
options bit <12> is set
to 1 and a Guardian user-id is passed, or (2)
options bit <12> is set
to 0 and a numeric Guardian user-id is passed and the SAFEGUARD
NAMELOGON option is set to ON.
3 $CMON rejected the logon.
4
Conditions for a blind logon are not satisfied. This status bit is set
when blind logon is configured (either through Safeguard software or
using
options.<13>), dialog-id is not provided, and options.<8>
is not set.
5 Authentication record frozen.
6 Authentication record expired.
9
dialog-id was not provided. Caller should set dialog-id correctly
and call USER_AUTHENTICATE_ again, with the same parameters.
10
dialog-id was not provided. Caller should set dialog-id correctly
and call USER_AUTHENTICATE_ again, with the same parameters.
11
dialog-id was not provided. Caller should set dialog-id correctly
and call USER_AUTHENTICATE_ again, with the same parameters.
12
dialog-id was not provided. Caller should set dialog-id correctly
and call USER_AUTHENTICATE_ again, with the same parameters.
13 Password change request: new password is too short. New
password is rejected.
14 Password change request: new password is too long. New
password is rejected.
15 Password change request: new password does not conform to
password history (password cannot be reused). New password is
rejected.