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

# EOS_PT_FWDLINKINFO

This function returns the linkfield to the given level.

## Examples

In this example, we return the linkfield connecting the Desc-Loc level to the following Observations level. (These levels are defined in the EOS_PT_DEFLEVEL function.):

status = EOS_PT_FWDLINKINFO(pointID2, 1, linkfield)

## Syntax

Result = EOS_PT_FWDLINKINFO(pointID, level, linkfield)

## Return Value

Returns SUCCEED (0) if successful and FAIL (–1) otherwise.

## Arguments

### pointID

Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.

### level

Point level (0-based long).

### linkfield

A named variable that will contain the link field (string).

## Keywords

None

## Version History

5.2 | Introduced