IN: Location identifier; may be a file, group, dataset, named datatype or attribute identifier
const char *name
IN: Path to the object, relative toloc_id
IN: Access property list identifier for the link pointing to the object
H5O_OPEN opens a group, dataset, or committed (named) datatype specified by a location, loc_id, and a path name,name, in an HDF5 file.
This function opens the object in the same manner asH5G_OPEN,H5T_OPEN, andH5D_OPEN. However,H5O_OPENdoes not require the type of object to be known beforehand. This can be useful with user-defined links, for instance, when only a path may be known.H5O_OPEN cannot be used to open a dataspace, attribute, property list, or file.
Once an object of unknown type has been opened with H5O_OPEN, the type of that object can be determined by means of an H5I_GET_TYPE call.
loc_idcan be either a file or group identifier.namemust be the path to that object relative toloc_id.
lapl_idis the link access property list associated with the link pointing to the object. If default link access properties are appropriate, this can be passed in asH5P_DEFAULT.
When it is no longer needed, the opened object should be closed withH5O_CLOSE, H5G_CLOSE, H5T_CLOSE, or H5D_CLOSE.
Returns an object identifier for the opened object if successful; otherwise returns a negative value.