Name: H5Freopen
Signature:
hid_t H5Freopen(hid_t file_id )
Purpose:
Returns a new identifier for a previously-opened HDF5 file.
Description:
H5Freopen returns a new file identifier for an already-open HDF5 file, as specified by file_id. Both identifiers share caches and other information. The only difference between the identifiers is that the new identifier is not mounted anywhere and no files are mounted on it.

Note that there is no circumstance under which H5Freopen can actually open a closed file; the file must already be open and have an active file_id. E.g., one cannot close a file with H5Fclose (file_id) then use H5Freopen (file_id) to reopen it.

The new file identifier should be closed by calling H5Fclose when it is no longer needed.

Parameters:
Returns:
Returns a new file identifier if successful; otherwise returns a negative value.
Fortran90 Interface: h5freopen_f
SUBROUTINE h5freopen_f(file_id, new_file_id, hdferr)
  IMPLICIT NONE 
  INTEGER(HID_T), INTENT(IN)  :: file_id     ! File identifier 
  INTEGER(HID_T), INTENT(OUT) :: new_file_id ! New file identifier 
  INTEGER, INTENT(OUT)        :: hdferr      ! Error code 
                                             ! 0 on success and -1 on failure
END SUBROUTINE h5freopen_f