retrieve_validated_user_name

	status.i4.v = retrieve_validated_user_name(user_name.i1a.r
						   [,seconds_ago.u4.r])

	This routine retrieves the most recently entered validated
	user name.  This name must have been entered by a user and
	validated by a previous call to either user_validation_c
	or user_password.

	user_name	returned null terminated user name string
			(USER_NAME_LEN + 1 characters)
	[seconds_ago]	returned number of seconds ago that the user
			name was validated
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_NOINIT		no user-entered validated user name exists
	CLIB_TIMEOUT		user name has timed out

	This function requires the following include files:

	cbslib_h

	Related functions:

	user_validation_c, user_password, set_validated_user_name_timeout_c,
	destroy_validated_user_name, my_current_user_name, my_user_name,
	get_personal_user_name_c

	C/C++ usage:

	char	user_name[USER_NAME_LEN+1];
	int	status;
	unsigned int	seconds_ago;

	status = retrieve_validated_user_name(user_name,&seconds_ago);