Name: H5Pset_obj_track_times
Signature:
  herr_t `H5Pset_obj_track_times`( hid_t `ocpl_id`, hbool_t `track_times` )

Purpose:
  Sets the recording of times associated with an object.

Description:
  `H5Pset_obj_track_times` sets a property in the object creation property list, `ocpl_id`, that governs the recording of times associated with an object.

  If `track_times` is `TRUE`, time data will be recorded. If `track_times` is `FALSE`, time data will not be recorded.

  Time data can be retrieved with `H5Oget_info`, which will return it in the `H5O_info_t` struct.

  If times are not tracked, they will be reported as follows when queried:
  `12:00 AM UDT, Jan. 1, 1970`
  That date and time are commonly used to represent the beginning of the UNIX epoch.

Parameters:

hid_t `ocpl_id` | IN: Object creation property list identifier
hbool_t `track_times` | IN: Boolean value, `TRUE` or `FALSE`, specifying whether object times are to be tracked

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

Fortran90 Interface: h5pset_obj_track_times_f

      SUBROUTINE h5pset_obj_track_times_f(plist_id, flag, hdferr)
        IMPLICIT NONE
        INTEGER(HID_T), INTENT(IN) :: plist_id
                                       ! Dataset creation property
                                       ! list identifier
        LOGICAL, INTENT(IN) :: flag    ! Object timestamp setting
        INTEGER, INTENT(OUT) :: hdferr ! Error code
                                       ! 0 on success and -1 on failure
      END SUBROUTINE h5pset_obj_track_times_f

History:

  Release | C
  1.8.0 | Function introduced in this release.