[Back to Interface] [Prev] [Next]

Vsetattr/vfsnatt/vfscatt

intn Vsetattr(int32 vgroup_id, char *attr_name, int32 data_type, int32 count, VOIDP values)

vgroup_id IN:

Vgroup identifier returned by Vattach

attr_name IN:

Name of the attribute

data_type IN:

Data type of the attribute

count IN:

Number of values the attribute contains

values IN:

Buffer containing the attribute values

Purpose

Attaches an attribute to a vgroup.

Return value

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

Description

Vsetattr attaches an attribute to the vgroup identified by the parameter vgroup_id. The attribute name is specified by the parameter attr_name and the attribute data type is specified by the parameter data_type. The values of the attribute are specified by the parameter values, and the number of values in the attribute is specified by the parameter count. Refer to Table 1A in Section I of this manual for a listing of all valid data types.

If the attribute already exists, the new values will replace the current ones, provided the data type and the number of attribute values have not been changed. If either the data type or the order have been changed, Vsetattr will return FAIL (or -1).

FORTRAN

integer vfsnatt(vgroup_id, attr_name, data_type, count, values)

integer vgroup_id, data_type, count

<valid numeric data type> values(*)

character*(*) attr_name

integer vfscatt(vgroup_id, attr_name, data_type, count, values)

integer vgroup_id, data_type, count

character*(*) attr_name, values(*)



[Back to Interface] [Prev] [Next]

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