Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (T-V)
Guardian Procedure Calls Reference Manual—522629-013
15-28
USER_AUTHENTICATE_ Procedure
USER_AUTHENTICATE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
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 ] );