The features described in this topic are obsolete
and should not be used in new IDL code.

HDF_VD_GETNEXT

The HDF_VD_GETNEXT function returns the reference number of the next object inside a VData in an HDF file. If Id is -1, the first item in the VData is returned, otherwise Id should be set to a reference number previously returned by HDF_VD_GETNEXT. HDF_VD_GETNEXT returns -1 if there was an error or there are no more objects after the one specified by Id.

Syntax

Result = HDF_VD_GETNEXT(VData, Id)

Arguments

VData

The VData handle returned by a previous call to HDF_VD_ATTACH.

Id

A VGroup or VData reference number obtained by a previous call to HDF_VG_GETNEXT or HDF_VD_GETNEXT. Alternatively, this value can be set to -1 to return the first item in the VData.

Version History

Introduced: 4.0