If the sizes specified in size are smaller than the dataset’s current dimension sizes, H5D_SET_EXTENT will reduce the dataset’s dimension sizes to the specified values. It is the user application’s responsibility to ensure that valuable data is not lost as H5D_SET_EXTENTdoes not check.
Except for external datasets, H5D_SET_EXTENTis for use with chunked datasets only, not contiguous datasets.
A call to H5D_SET_EXTENT affects the dataspace of a dataset. If a dataspace handle was open for a dataset prior to a call to H5D_SET_EXTENT then that dataspace handle will no longer reflect the correct dataspace extent of the dataset. H5D_GET_SPACE must be called (after closing the previous handle) to obtain the current dataspace extent.
Returns a non-negative value if successful; otherwise returns a negative value.
Function implemented but not supported in this release.