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

# HDF_AN_CREATEF

This function creates an HDF AN file annotation of the type specified by the parameter Annotation_type. Use HDF_AN_CREATE to create a data annotation. Currently, the user must write to a newly-created annotation before creating another annotation of the same type. Creating two consecutive annotations of the same type causes the second call to HDF_AN_CREATE to return FAIL (-1)

## Syntax

Result = HDF_AN_CREATEF(Annotation_id, Annotation_type)

## Return Value

Returns the file annotation identifier (Annotation_id) if successful or FAIL (-1) otherwise.

## Arguments

### Annotation_id

HDF_AN_ INTERFACE identifier returned by HDF_AN_START.

### Annotation_type

Type of the file annotation. The file annotation identifier returned can either represent a file label or a file description. Valid values for Annotation_type are:

- 2 = file label
- 3 = file description

## Keywords

None

## Version History

5.2 | Introduced