file_directory_select_c

	status.i4.v = file_directory_select_c(top_row.i4.v, left_column.i4.v,
					      root_directory.i1a.r,
					      directory.i1a.r,
					      display_mode.i4.v,
					      full_names.i4.v)
	
	This routine displays subdirectories of the requested root directory.
	The directory tree can be traversed by double clicking on a given
	subdirectory.  If the user selects a directory, it will be returned
	in "directory".

	top_row		top row of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	left_column	left column of window (use WMNGR_CENTER for centering
			or WINDOW_xxx_COORD macros in macro for special
			positioning)
	root_directory	null terminated starting directory string including disk
			(If a value of NULL is passed, the user will be
			 prompted to enter a directory.)
	directory	returned null terminated selected directory string
			(caller should allocate MAXPATHLEN bytes for this)
	display_mode	display mode for parent and child directories
			(FILE_VIEW_PARENT -> show parent directory,
			 FILE_VIEW_PARENT_CONSTRAIN -> show parent
						       directory but do not
						       allow access to root's
						       parent,
			 FILE_VIEW_FAMDIR -> show parent and child
					     directories simultaneously)
			If the value passed is FILE_VIEW_PARENT, a double
			click on a directory name will display that directory.
	full_names	directory name display mode
			(TRUE -> display the full name of the directory,
			 FALSE -> display [*.sub_dir_name])

	This function returns ACNET status values as follows:

	OK			success
	CBS_MEMFAIL		failed in allocating dynamic memory
	CBS_INVARG		invalid file specification passed
	CBS_NO_SUCH		no directories matched the requested
				specification
	CBS_ABORT		user abort, no selected directory returned
	
	
	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	file_view_select, file_view_find, file_view_read, dialog_setup_c,
	window_restore_hint_c

	C/C++ usage:

	static const char	root_directory[] = "disk:[some_account]";
	char	directory[256];
	int	status;
	int	top_row = WMNGR_CENTER;
	int	left_column = WMNGR_CENTER;
	int	display_mode = FILE_VIEW_FAMDIR;
	int	full_names = TRUE;

	status = file_directory_select_c(top_row,left_column,root_directory,
					 directory,display_mode,full_names);