[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.