|
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) |