Replace this text with the Fortran function signature
const href_t *ref_ptr
IN: Pointer to reference to query
IN: Valid object access property list identifier
IN/OUT: A buffer to place the object name of the reference
IN: The size of the name buffer
H5R_GET_OBJ_NAME retrieves the object 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_OBJ_NAME call can be made. The return value of this call will be the size of the object name. That value can then be assigned to size for a second H5R_GET_OBJ_NAME call, which will retrieve the actual name. If there is no name associated with the object identifier or if the name is NULL, H5R_GET_OBJ_NAME returns the size of the name buffer (the size does not include the NULL terminator).
If the reference is an object reference, name will be returned with a name for the referenced object. If the reference is a dataset region reference, name will contain a name for the object containing the referenced region. If the reference is an attribute reference, name will contain a name for the object the attribute is attached to. Note that an object in an HDF5 file may have multiple paths if there are multiple links pointing to it. This function may return any one of these paths.
Returns the length of the name if successful, returning 0 (zero) if no name is associated with the identifier. Otherwise returns a negative value.