Guardian Procedure Calls Reference Manual

USER_AUTHENTICATE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Safeguard Considerations
OSS Considerations
Example
Related Programming Manuals
Summary
The USER_AUTHENTICATE_ procedure verifies that a user exists and optionally logs on the user.
This procedure should be called in a dialog mode to allow a dialog between the security mechanism
and the application.
Syntax for C Programmers
#include <cextdecs(USER_AUTHENTICATE_)>
short USER_AUTHENTICATE_ ( char *inputtext
,short inputtext-len
,[ short options ]
,[ __int32_t *dialog-id ]
,[ short *status ]
,[ short *status-flags ]
,[ char *displaytext ]
,[ short displaytext-maxlen ]
,[ short *displaytext-len ]
,[ short cmon-timeout ]
,[ char *termname ]
,[ short termname-len ]
,[ char *volsubvol ]
,[ short volsubvol-maxlen ]
,[ short *volsubvol-len ]
,[ char *initdir ]
,[ short initdir-maxlen ]
,[ short *initdir-len ]
,[ char *initprog ]
,[ short initprog-maxlen ]
,[ short *initprog-len ]
,[ short *initprog-type ]
,[ __int32_t *last-logon-time ]
,[ __int32_t *time-password-expires ]
,[ char *ipaddress ]
,[ short ipaddress-len ] );
• CEXTDECS (through 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.
USER_AUTHENTICATE_ Procedure 1441