dio_read_last_setting_c

	status.i4.v = dio_read_last_setting_c(device_indices.i4a.r,
					      values.r8a.r,
					      errors.i2a.r [,units_text.i1a.r]
					      [,num_devices.i4.v]
					      [,num_elements.i4a.r]
					      [,start_element.i4a.r]
					      [,vals_per_dev.i4a.r])

	This routine returns the setting information that is presently
	stored in the database for the requested devices.  If "num_devices"
	is specified, information for a list of devices can be retrieved.
	Not all front ends support this feature, and even front ends that
	do support saved settings may not do so for all devices.
	(Note: Only the setting property is supported by this routine.)

	device_indices	device index or array of device indices
	values		returned setting values
			(Note: The number of values returned for a
			 requested array device is equal to the maximum
			 number of values for that device even if no
			 database setting record exists.  If the device/
			 property doesn't exist, a single value will be
			 returned for that entry.)
	errors		returned ACNET status value or array of status values
			(a value of DBM_NOREC will be returned for any entry
			 which does not have a database setting record)
	[units_text]	returned setting units text
			(LEN_DEV_UNITS characters per device) (default is NULL)
	[num_devices]	number of devices (default is 1)
	[num_elements]	array of number of array elements to return (>= 1)
			(Note: If the first value is less than zero, all
			 devices will be submitted with the number of elements
			 requested equal to the absolute value of that value.)
			(If a value of NULL is passed for this argument,
			 the entire array for each device will be returned.)
			(default is NULL)
	[start_element]	array of first elements to return (starting at 0)
			(Note: If the first value is less than zero, all
			 devices will be submitted with the starting element
			 requested equal to the absolute value of that value.)
			(If a value of NULL is passed for this argument,
			 an offset of 0 will be used for each device.)
			(default is NULL)
	[vals_per_dev]	returned number of values per device
			(A value of NULL can be passed for this argument if
			 this information is not needed.) (default is NULL)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid number of devices passed
	DIO_MEMFAIL		memory allocation failure
	negative value		ACNET format error indicating overall failure
	positive value		number of devices in error indicating partial
				success

	This function requires the following include files:

	cnsparam_h, diolib_h, acnet_errors_h

	Related functions:

	dio_get_last_setting, dio_get_last_setting_raw,
	dio_restore_last_setting, dio_cache_scaling_info_c,
	dio_has_setting_record_c, dio_get_recent_setting_info_c,
	error_in_list(_c)

	C/C++ usage:

	char	units_text[NUM_DEVICES][LEN_DEV_UNITS];
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_devices = NUM_DEVICES;
	int	num_elements = -1;
	int	*start_element = (int *) NULL;
	int	values_per_dev[NUM_DEVICES];
	double	values[NUM_DEVICES];

	status = dio_read_last_setting_c(device_indices,values,errors,
					 (char *) units_text,num_devices,
					 &num_elements,start_element,
					 values_per_dev);