Routines (alphabetical) > Routines: H > HDF Routines > HDF_AN_ANNLIST

# HDF_AN_ANNLIST

This function obtains a list of identifiers of the annotations that are of the type specified by the parameter Annotation_type and are attached to the object identified by its tag, Object_tag, and its reference number, Object_ref.

## Syntax

Result = HDF_AN_ANNLIST(Annotation_id, Annotation_type, Object_tag, Object_ref, Annotation_list)

## Return Value

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

## Arguments

### Annotation_id

HDF AN interface identifier returned by HDF_AN_START.

### Annotation_type

Type of the annotation. Since this routine is implemented only to obtain the identifiers of data annotations and not file annotations, the valid values of Annotation_type are:

- 0 = data label
- 1 = data description

### Object_tag

HDF tag of the object.

### Object_ref

HDF reference number of the object.

### Annotation_list

A named variable that will contain the annotation identifiers.

## Keywords

None

## Version History

5.2 | Introduced