input_generic_user_password_c

	status.i4.v = input_generic_user_password_c(prompt.i1a.r,
						    max_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.

	prompt		null terminated prompt string
	max_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)
	[top_row]	desired top row of password dialog
			(default is WMNGR_CENTER)
	[left_column]	desired left column of password dialog
			(default is WMNGR_CENTER)

	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:

	cbslib_h

	Related functions:

	input_generic_login_info_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	prompt[] = "Enter password";
	char	password[MAX_LENGTH+1];
	int	status;
	int	max_length = MAX_LENGTH;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	unsigned int	options = LOGIN_OPT_NONE;

	status = input_generic_user_password_c(prompt,max_length,password,
					       options,top_row,left_column);