Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-29
USER_AUTHENTICATE_ Procedure
•
CEXTDECS (via the included file TNSINTH) defines 32-bit values as the typedef
__int32_t which for TNS and TNS/R compiles is defined as
long and for TNS/E
compiles is defined as
int.
Syntax for TAL Programmers
Parameters
error returned value
INT
returns an error number indicating the outcome of the call. Common errors
returned are:
0 No error.
13 Invalid
termname parameter.
22 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.
29 Missing parameter. Either this procedure is called without specifying
input
text:inputtext-len, or a parameter required by another
parameter is not specified.
48 Security violation. The user specified in input
text:inputtext-len is
undefined, or an error occurred during a dialog with the Safeguard product.
See the
status parameter for detailed error information.
error := USER_AUTHENTICATE_
( inputtext:inputtext-len ! i:i
,[ options ] ! i
,[ dialog-id ] ! i,o
,[ status ] ! o
,[ status-flags ] ! o
,[ displaytext:displaytext-maxlen ] ! o:i
,[ displaytext-len ] ! o
,[ cmon-timeout ] ! i
,[ termname:termname-len ] ! i:i
,[ volsubvol:volsubvol-maxlen ] ! o:i
,[ volsubvol-len ] ! o
,[ initdir:initdir-maxlen ] ! o:i
,[ initdir-len ] ! o
,[ initprog:initprog-maxlen ] ! o:i
,[ initprog-len ] ! o
,[ initprog-type ] ! o
,[ last-logon-time ] ! o
,[ time-password-expires ] ); ! o