HDF5 objects include datasets, groups, and committed datatypes. Only
hid_t identifiers that represent these objects can be passed to the function.
Passing in an
hid_t identifier that represents any other HDF5 entity is considered an error.
It is an error to pass an HDF5 file identifier (obtained from H5F_OPEN or H5F_CREATE) to this function. Use H5F_ENABLE_MDC_FLUSHES instead.
Using this function on an object that has not had flushes disabled is considered an error. The state of an object can be determined with H5O_ARE_FLUSHES_DISABLED.
Individual objects can be returned to the default flush algorithm with this function after H5F_DISABLE_MDC_FLUSHES has been used to globally prevent flushes.
An object will be returned to the default flush algorithm when it is closed.
All objects will be returned to the default flush algorithm when the file is closed.
An object’s entries will not necessarily be flushed as a result of calling this function.