Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_PT_ATTACH

# EOS_PT_ATTACH

This function attaches to the point using the pointname parameter as the identifier.

## Examples

In this example, we attach to the previously created point, “ExamplePoint”, within the HDF file, PointFile.hdf, referred to by the handle, fid:

pointID = EOS_PT_ATTACH(fid, "ExamplePoint")

The point can then be referenced by subsequent routines using the handle, pointID.

## Syntax

Result = EOS_PT_ATTACH(fid, pointname)

## Return Value

Returns the point handle (pointID) if successful and FAIL (–1) otherwise.Typical reasons for failure are an improper point file id or point name.

## Arguments

### fid

Point file id (long) returned by EOS_PT_OPEN.

### pointname

Name of point (string) to be attached.

## Keywords

None

## Version History

5.2 | Introduced

## See Also

EOS_PT_DETACH