Guardian Programming Reference Summary for C

Functions Summary (R-Z)
Guardian Programming Reference Summary for C—522630-001
8-33
USER_AUTHENTICATE_
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 user.
return value:
#include <cextdecs(USER_AUTHENTICATE_)>
short USER_AUTHENTICATE_
( char *inputtext /* i */
,short inputtext-len /* i */
,[ short options ] /* i */
,[ long *dialog-id ] /* i */
,[ short *status ] /* o */
,[ short *status-flags ] /* o */
,[ char *displaytext ] /* o */
,[ short displaytext-maxlen ] /* i */
,[ short *displaytext-len ] /* o */
,[ short cmon-timeout ] /* i */
,[ char *termname ] /* i */
,[ short termname-len ] /* i */
,[ char *volsubvol ] /* o */
,[ short volsubvol-maxlen ] /* i */
,[ short *volsubvol-len ] /* o */
,[ char *initdir ] /* o */
,[ short initdir-maxlen ] /* i */
,[ short *initdir-len ] /* o */
,[ char *initprog ] /* o */
,[ short initprog-maxlen ] /* i */
,[ short *initprog-len ] /* o */
,[ short *initprog-type ] /* o */
,[ long *last-logon-time ] /* o */
,[ long *time-password-expires ] );/* o */
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
inputtext:inputtext-len, or a parameter required by another
parameter is not specified.
48 = Security violation. The user specified in inputtext:inputtext-len is
undefined, or an error occurred during a dialog with Safeguard.