destroy_validated_user_name

	status.i4.v = destroy_validated_user_name()

	This routine destroys the most recently entered validated user name.
	This affects user-entered names which have been validated by a
	previous call to either user_validation_c or user_password.

	This function returns ACNET status values as follows:

	OK			success
	CLIB_NOINIT		no user-entered validated user name exists

	This function requires the following include files:

	cbslib_h

	Related functions:

	user_validation_c, user_password, retrieve_validated_user_name,
	set_validated_user_name_timeout_c, my_current_user_name, my_user_name,
	get_personal_user_name_c

	C/C++ usage:

	int	status;

	status = destroy_validated_user_name();