status.i4.v = user_password(user_name.i1a.r [,no_term.i4.v])
This routine allows an application to screen its use. It prompts
the user for a password. The programmer sets the user name in
the call to this routine. It should be called as the first
routine in the program intialization. If the password query
fails, the program execution is terminated.
The password expected is to be set by the 'conpwd' utility. 'conpwd'
is available as a command line program on any Linux console.
user_name null terminated user name string
(up to USER_NAME_LEN characters plus null)
[no_term] failure handling code
(TRUE -> do not exit the program on password entry
FALSE -> exit the program on password entry
This function returns status values as follows:
TRUE password was successfully entered
FALSE password was not successfully entered
This function requires the following include files:
user_validation_c, dialog_setup_c, window_restore_hint_c,
static const char user_name = "smith";
int no_term = FALSE;
status = user_password(user_name,no_term);