Last modified: 25 February 2014

Name: H5Fget_mdc_flush_disabled_obj_ids

Signature:
herr_t H5Fget_mdc_flush_disabled_obj_ids( hid_t file_id, int *n_objects, hid_t object_ids[] )

Purpose:
Returns a list of all object identifiers for which flushes have been disabled in a file’s metadata cache.

Description:
The H5O/H5Fenable/disable_mdc_flushes() and associated H5Xflush() functions can be used to control the flushing of entries from a file’s metadata cache. Metadata cache entries can be controlled at both the individual HDF5 object level (datasets, groups, committed datatypes) and the entire metadata cache level.

Note:
The object_ids array must be allocated by the caller. The appropriate size can be determined by calling the function with object_ids set to NULL, which will return the number of objects via the n_objects pointer. The correct size of the array will then be (*n_objects * sizeof(hid_t)).

Only HDF5 file identifiers (obtained from H5Fopen() or H5Fcreate()) may be passed to this function.

Passing in a hid_t identifier that represents any other HDF5 entity is considered an error.


Parameters:
hid_t file_id IN: File identifier.
int *n_objects OUT: Number of object identifiers being returned.
hid_t object_ids[]    OUT: Array of object identifiers (allocated by caller).

Returns:
Returns a non-negative value if successful; otherwise returns a negative value.

Fortran Interface:
None

See Also:



History:
Release     Change
1.10.0 C function introduced with this release.