This function retrieves the HDF tag/reference number pair of the HDF AN annotation identified by its annotation identifier.

Syntax


Result = HDF_AN_ID2TAGREF(Annotation_id, Annotation_tag, Annotation_ref)

Return Value


Returns SUCCEED (0) if successful or FAIL (-1) otherwise.

Arguments


Annotation_id

HDF AN annotation identifier returned by HDF_AN_SELECT, HDF_AN_CREATE or HDF_AN_CREATEF.

Annotation_tag

A named variable that will contain the HDF tag of the annotation. Possible values returned in Annotation_tag are:

  • 104 = data label (DFTAG_DIL)
  • 105 = data description (DFTAG_DIA)
  • 100 = file label (DFTAG_FID)
  • 101 = file description (DFTAG_FD)

Annotation_ref

A named variable that will contain the HDF reference number of the annotation.

Keywords


None

Version History


5.2

Introduced