Creating a Link
Function Syntax
Create a hard link to an object.
herr_t H5Lcreate_hard(hid_t curLoc, const char * curName, hid_t dstLoc, const char * dstName, hid_t lcpl, hid_t lapl)
Parameters
Parameter |
Description |
Value Range |
Input/Output |
|---|---|---|---|
curLoc |
Location identifier, which may be that of a file, group, dataset, named data type, or attribute |
Integer |
Input |
*curName |
Name of the target object, which must already exist |
Non-empty |
Input |
dstLoc |
Location identifier, which may be that of a file, group, dataset, named data type, or attribute |
Integer |
Input |
*dstName |
Name of the new link |
Non-empty |
Input |
lcpl |
Link creation property list identifier |
Integer |
Input |
lapl |
Link access property list identifier |
Integer |
Input |
Return Value
- Success: non-negative value
- Failure: negative value
Parent topic: Link APIs