user_validation_c

	status.i4.v = user_validation_c(top_row.i4.v, left_column.i4.v,
					user_name.i1a.r)

	This routine allows an application to query the identity of
	its user.

	top_row		upper row where input window should be placed
	left_column	left column where input window should be placed
	user_name	returned user name (USER_NAME_LEN + 1 characters)
			(This string is filled only when a valid
			 user name/password is entered.)

	This function returns status values as follows:

	TRUE			valid user name/password entered
	FALSE			validation failed

	This function requires the following include files:

	cnsparam_h, cbslib_h

	Related functions:

	user_password, 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:

	char	user_name[USER_NAME_LEN+1];
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	
	status = user_validation_c(top_row,left_column,user_name);