IN: Location identifier of subject group; may be a file, group, dataset, named datatype or attribute identifier
const char *group_name
IN: Name of subject group
IN: Type of index; valid values include: NAME Indexed by name CORDER Indexed by creation order
IN: Order within field or index; valid values include: H5_ITER_INC Iterate in increasing order H5_ITER_DEC Iterate in decreasing order H5_ITER_NATIVE Iterate in fastest order
IN: Link for which to retrieve information
OUT: Pointer to buffer in which link value is returned
IN: Size in bytes of group_name
IN: Link access property list
H5L_GET_VAL_IDX retrieves the value of the nth link in a group, according to the specified order, order, within an index, index.
For soft links, the value is the path name of the object pointed to.
For external links, this is a compound value containing file and path name information; to use this external link information, it must first be decoded with H5L_UNPACK_ELINK_VAL
For user-defined links, this value will be described in the definition of the user-defined link type.
This function will fail if called on a hard link.
loc_id specifies the location identifier of the group specified by group_name.
group_name specifies the group in which the link exists. If loc_id already specifies the group in which the link exists, group_name must be a dot (.).
The size in bytes of group_name is specified in size. If size is unknown, it can be determined via an initial H5L_GET_VAL_IDXcall with size set to NULL; size will be returned with the actual size of group_name.
If the type of the link is unknown or uncertain, H5L_GET_VAL_IDX should be called only after the type has been determined via a call to H5L_GET_INFO_BY_IDX.
Returns a non-negative value if successful; otherwise returns a negative value.