API Guide
601355 Rev A API Functions 2-181
Functions
VS_Drive_GetFields VS_Drive_GetFields retrieves information associated
with a drive handle. A drive handle is used to pass drive
information to and from VolServ.
Synopsis VST_BOOLEAN VS_Drive_GetFields
( VST_DRIVE_HANDLE handle,
“…”,
VSID_ENDFIELD )
Arguments •handle = Drive handle for which information is being
requested.
•“…” = Variable length argument list consisting of pairs of
arguments. Each pair of arguments consists of a parameter
identifier, followed by a pointer to a location where the
value of the parameter may be stored. The parameter
identifiers and types this function accepts are shown in the
following "Parameters" paragraph.
•VSID_ENDFIELD = Required at the end of the variable
length argument list to indicate the end of the list.
Parame ters
Parameter Type Description
VSID_ARCHIVE_NAME
(VST_ARCHIVE_NAME) Pointer to the name of the archive with which
this drive is associated. Valid archive names
may contain up to 16 alphanumeric
characters, including spaces. Leading and
trailing spaces are not permitted.
VSID_ASSIGNMENT (VST_ASSIGNMENT *) Pointer to the current assignment of this drive.
Valid VSID_ASSIGNMENT values are
enumerated in the vs_types.h file.