|
Purpose
|
Reads the label assigned to the data object identified by the given tag and reference number. |
|
Return value
|
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise. |
|
Description
|
The parameter buf_len specifies the storage space available for the label. The length of buf_len must account for the null termination character appended to the annotation. |