Returns the dataset access property list associated with a dataset
hid_t H5Dget_access_plist( hid_t dataset_id )
IN: Identifier of the dataset to get access property list of
H5D_GET_ACCESS_PLIST returns a copy of the dataset access property list used to open the specified dataset. Modifications to the returned property list will have no effect on the dataset it was retrieved from.
The chunk cache parameters in the returned property lists will be those used by the dataset. If the properties in the file access property list were used to determine the dataset's chunk cache configuration, then those properties will be present in the returned dataset access property list. If the dataset does not use a chunked layout, then the chunk cache properties will be set to the default. The chunk cache properties in the returned list are considered to be “set”, and any use of this list will override the corresponding properties in the file’s file access property list.
All link access properties in the returned list will be set to the default values.
The access property list identifier should be released with H5P_CLOSE when the identifier is no longer needed so that resource leaks will not develop.
Returns a dataset access property list identifier if successful; otherwise returns a negative value.