[Back to Interface] [Prev] [Next]

VSgetname/vsfgnam

int32 VSgetname(int32 vdata_id, char *vdata_name)

vdata_id IN:

Vdata identifier returned by VSattach

vdata_name OUT:

Vdata name

Purpose

Retrieves the name of a vdata.

Return value

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

Description

VSgetname retrieves the name of the vdata identified by the parameter vdata_id into the buffer vdata_name.

The user must allocate the memory space for the buffer vdata_name before calling VSgetname. If the vdata does not have a name, a null string is returned in the parameter vdata_name . The maximum length of a vdata name is defined by VSNAMELENMAX (or 64)

FORTRAN

integer function vsfgnam(vdata_id, vdata_name)

integer vdata_id

character*(*) vdata_name



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.