input_generic_login_info_c

	status.i4.v = input_generic_login_info_c(name_prompt.i1a.r,
						 max_name_length.i4.v,
						 user_name.i1a.r,
						 password_prompt.i1a.r
						 max_pass_length.i4.v,
						 password.i1a.r
						 [,options.u4.v]
						 [,top_row.i4.v]
						 [,left_column.i4.v])

	This routine allows a user to enter a password.  If the
	password entry fails, the program execution may be
	optionally terminated.

	name_prompt	null terminated user name prompt string
	max_name_length	maximum length of returned password string
	user_name	returned null terminated user name string
	password_prompt	null terminated password prompt string
	max_pass_length	maximum length of returned password string
	password	returned null terminated password string
	[options]	entry options
			(LOGIN_OPT_NONE -> no options selected (default),
			 LOGIN_OPT_EXIT_ON_ERROR -> exit the program on
						    name/password entry
						    failure,
			 LOGIN_OPT_ALLOW_NULL_PASSWORD -> allow a null
							  (0 length) password,
			 LOGIN_OPT_NO_PASSWORD_NEEDED -> no password needed)
	[top_row]	desired top row of name/password dialogs
			(default is WMNGR_CENTER)
	[left_column]	desired left column of name/password dialogs
			(default is WMNGR_CENTER)

	This function returns status values as follows:

	TRUE			user name/password was successfully entered
	FALSE			user name/password was not successfully entered

	This function requires the following include files:

	cbslib_h

	Related functions:

	input_generic_user_password_c, user_password, user_validation_c,
	dialog_setup_c, window_restore_hint_c,
	set_validated_user_name_timeout_c, retrieve_validated_user_name,
	destroy_validated_user_name, get_personal_user_name_c

	C/C++ usage:

	static const char	name_prompt[] = "Enter user name";
	static const char	password_prompt[] = "Enter password";
	char	user_name[MAX_NAME_LENGTH+1];
	char	password[MAX_PASS_LENGTH+1];
	int	status;
	int	max_name_length = MAX_NAME_LENGTH;
	int	max_pass_length = MAX_PASS_LENGTH;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	unsigned int	options = LOGIN_OPT_NONE;

	status = input_generic_login_info_c(name_prompt,max_name_length,
					    user_name,password_prompt,
					    max_pass_length,password,
					    options,top_row,left_column);