HP Data Entry and Forms Management System (VPLUS) Reference Manual (32209-90024)

Chapter 6 283
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VGETFILEINFO
Returns information about forms file to an application.
Syntax
VGETFILEINFO { comarea,infobuf,infobuflen }
Parameters
comarea Must be comarea name specified when the forms file was opened with
VOPENFORMF. If not already set, the following
comarea items must be set
before calling VGETFILEINFO:
cstatus Set to zero.
comarealen Set to total number of two-byte words in comarea .
VGETFILEINFO may set the following
comarea item:
cstatus Set to nonzero value if call unsuccessful.
infobuf A record through which you pass the request for forms file information and
to which the intrinsic returns the specified information. This parameter
must be initialized to spaces before filling in your request and calling
VGETFILEINFO. The layout of
infobuf is shown in Table 6-11. The two
required fields of
infobuf pass user-supplied parameters to
VGETFILEINFO as follows:
numofentries Specifies how many times you want the information
repeated (information is returned only about the forms file
associated with
comarea ; if you specify a number greater
than one, you get duplicate information).
entrylength Indicates how many two-byte words of information
(maximum 19 as shown in Table 6-11.) you want about the
file.
Remember that
infobuf must be initialized to spaces before filling in the
parameters.
infobuflen Two-byte integer variable set to number of two-byte words in infobuf .
Discussion
This intrinsic accesses an internal table and places information about the open forms file
into
infobuf. You tell VGETFILEINFO how much information you want about the file.