Guardian Programming Reference Summary for C

Functions Summary (R-Z)
Guardian Programming Reference Summary for C—522630-001
8-34
options
status
Values returned for error = 0:
Values returned for error = 48:
70 = Continue dialog. See the status parameter for detailed information on how
to set the inputttext parameter in the next call to
USER_AUTHENTICATE_.
160 = Invalid dialog-id parameter, invalid protocol, or dialog has exceeded two
minutes.
563 = The text to be returned in the displaytext parameter is longer than the
length specified by the displaytext-maxlen parameter.
Bits 0-7 Reserved (specify 0).
Bit 8 Echo is disabled by the caller (with a SETMODE 20) for password input.
Bit 9 Send $CMON the Prelogon^msg message (-59).
Bit 10 Send $CMON the Logon^msg message (-50).
Bit 11 Do not allow the super ID (255,255) to log on.
Bit 12 Do not allow a logon with a Guardian user ID.
Bit 13 Require blind logon.
Bit 14 Do not log on if $CMON has an error or timeout.
Bit 15 Log on and update the process's attributes to reflect the user's attributes.
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 Guardian user ID because options bit 12 is set to 1.
3 $CMON rejected logon.
5 Authentication record frozen.
6 Authentication record expired.
10 Password expired: User cannot log on.
13 Password change request: New password is too short. New password is
rejected.