[Top]
[Prev]
[Next]
[Bottom]
Vsetname/vfsnam
int32 Vsetname(int32
vgroup_id
, const char *
vgroup_name
)
vgroup_id
IN:
Vgroup identifier returned by
Vattach
vgroup_name
IN:
Name to be assigned to the vgroup
Purpose
Sets the name for a vgroup.
Return value
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.
Description
Vgroups each initially have a name of NULL, and may be renamed more than once. Note that the routine does not check for uniqueness of vgroup names.
Vgroup names are optional, but recommended. They serve as meaningful labels for user applications. If used, they should be unique.
The maximum length of
vgroup_name
is VGNAMELENMAX. If a longer name is specified it will be truncated to that length.
FORTRAN
integer function vfsnam(vgroup_id, vgroup_name)
integer vgroup_id
character* (*) vgroup_name
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.