Guardian Procedure Calls Reference Manual

You must either specify all of these parameters or specify none of them:
initprog:initprog-maxlen, initprog-len, and initprog-type.
last-logon-time
output
FIXED .EXT:ref:1
returns the Julian timestamp of when the specified user last logged on. If the specified user has
never logged on, 0F is returned.
time-password-expires
output
FIXED .EXT:ref:1
returns the Julian timestamp of when the password of the specified user expires. If either the
password cannot be changed at the time USER_AUTHENTICATE_ is called or the password
has no expiration date, 0F is returned.
ipaddress:ipaddress-len
input:input
STRING .EXT:ref:*, INT:value
if supplied and if ipaddress-len is not 0, is the IP address that will be audited in the
Safeguard audit authenticate records. If used, the value of ipaddress must be exactly
ipaddress-len bytes long.
Only the first 128 characters of the string are used. This procedure does not return an error if
the string exceeds 128 bytes in length.
This parameter pair is supported only on systems running H06.26 and later H-series RVUs and
J06.15 and later J-series RVUs.
Returned Value
INT
An error code that indicates the outcome of the call. Common errors returned are:
No error.0
Invalid termname parameter.13
Parameter out of bounds. An input parameter is not within the valid range, or return information does not fit
into the length of the space provided, or an output parameter overlays the stack marker that was created by
calling this procedure.
22
Missing parameter. Either this procedure is called without specifying inputtext:inputtext-len, or a
parameter required by another parameter is not specified.
29
Security violation. The user specified in inputtext:inputtext-len is undefined, or an error occurred
during a dialog with the Safeguard product. For detailed error information, see the status parameter.
48
Continue dialog. For detailed information on how to set the inputtext parameter in the next call to
USER_AUTHENTICATE_, see the status parameter.
70
Invalid dialog-id parameter, invalid protocol, or dialog has exceeded two minutes.160
The text to be returned in the displaytext parameter is longer than the length specified by the
displaytext-maxlen parameter.
563
Two or more parameters provided are incompatible.590
Exceeded the maximum number of allowed concurrent requests.1554
For more information on file-system error messages, see the Guardian Procedure Errors and
Messages Manual.
USER_AUTHENTICATE_ Procedure 1447