Replace this text with the Fortran function signature
const href_t *ref_ptr
IN: Pointer to reference to query
IN/OUT: A buffer to place the file name of the reference
IN: The size of the name buffer
H5R_GET_FILE_NAME retrieves the file name for the object, region or attribute reference pointed to by ref_ptr. Up to size characters of the name are returned in name; additional characters, if any, are not returned to the user application. If the length of the name, which determines the required value of size, is unknown, a preliminary H5R_GET_FILE_NAME call can be made. The return value of this call will be the size of the file name. That value can then be assigned to size for a second H5R_GET_FILE_NAME call, which will retrieve the actual name.
Returns the length of the name if successful. Otherwise returns a negative value.