dio_extract_read_list_status_c

	status.i4.v = dio_extract_read_list_status_c(list_id.i4.v,
						     overall_status.i4.v,
						     errors.i2a.r
						     [,num_first.i4.r]
						     [,device_index.i4.r])

	This routine returns a representative error from a
	data acquisition list retrieval.

	list_id		returned list ID from previous call to
			'dio_bld_get(_raw)(_c)'
	overall_status	overall status value returned by the list retrieval
	errors		list of errors
	[num_first]	number of first error encountered in list  (A value
			of zero is returned if no errors are found in the
			list or if the overall status is returned.)
			(starts at 1)
			(default is NULL)
	[device_index]	returned device index matching the error
			(A value of zero is returned if no errors are found
			 in the list or if the overall status is returned.)
			(default is NULL)

	This function returns values as follows:

	OK			success
	otherwise		representative ACNET error status

	This function requires the following include files:

	diolib_h

	Related functions:

	dio_bld_get(_c), dio_bld_get_raw(_c), dio_get_lst,
	dio_get_lst_raw(_c), dio_read_list_length_c,
	dio_get_read_list_devices_c,  dio_read_list_single_entry_info_c,
	dio_list_info, dio_extract_set_list_status_c, dio_set_list_length_c,
	dio_set_list_single_entry_info_c, dio_slist_info,
	dio_get_set_list_devices_c, error_in_list(_c)

	C/C++ usage:

	short	errors[NUM_LIST_DEVICES];
	int	status;
	int	list_id;
	int	overall_status;
	int	num_first;
	int	device_index;

	status = dio_extract_read_list_status_c(list_id,overall_status,errors,
						&num_first,&device_index);