sr_snap_active_devices_c

	status.i4.v = sr_snap_active_devices_c(system.i4.v, device_index.i4.v,
					       num_devices.i4.r,
					       device_data.sp.r
					       [,options.u4.v])

	This routine returns active snapshot device information for
	detached snapshots.

	system		detached snapshot manager category to search for
	device_index	device index of device to search for
			(a value of 0 will result in a search for all devices)
	num_devices	returned number of matching snapshot devices found
	device_data	returned snapshot information
			(pointer to an array of structures of type
			 SRMNGR_SNAP_DEVICE_ENTRY_DATA)
			(Note: If a value of NULL is passed, only the number
			 of devices found will be returned.)
			(The data for these structures is allocated by this
			 routine and should be freed by the caller.)
	[options]	directory options (unused)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid system passed
	DIO_MEMFAIL		dynamic memory allocation failure
	DIO_NO_SUCH		no matching entries found
	otherwise		other ACNET error occurred

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	sr_snap_directory_info_c, sr_snap_date_to_file_info_c,
	sr_get_snapshot_c, sr_read_snapshot_c, sr_snapshot_header_c,
	sr_snapshot_info_c, sr_snapshot_info_list_c, sr_get_device_c,
	sr_get_device_raw_c, sr_data_length_c, sr_directory_info_c,
	sr_directory_info_by_date_c, sr_set_source_c, sr_file_menu_c,
	sr_category_menu_c, sr_sda_select_directory_c, sr_sda_set_directory_c,
	sr_sda_file_number_c, sr_sda_store_number_c

	C/C++ usage:

	int	status;
	int	system = SRMNGR_SNAP_SYSTEM_BOOSTER;
	int	device_index = 0;
	int	num_devices;
	unsigned int	options = 0;
	SRMNGR_SNAP_DEVICE_ENTRY_DATA	*device_data;

	status = sr_snap_active_devices_c(system,device_index,&num_devices,
					  &device_data,options);