Var
The Var
structure depicts the organization of data in a file-version resource. This
structure is not a true C-language structure because it contains
variable-length members. This structure was created solely to depict the
organization of data in a version resource and does not appear in any of the
header files shipped with the Microsoft Win32 Software Development Kit (SDK).
The Var
structure typically contains a list of languages that the version of the
application or dynamic-link library (DLL) supports.
Var {
WORD wLength;
WORD wValueLength;
WORD
wType;
WCHAR
szKey[];
WORD Padding[];
WORD Value[];
};
Members
wLength
Specifies the
length of the version resource.
wValueLength
Specifies the
length of the Value member in the current VS_VERSION_INFO
structure. This value is zero if there is no Value member associated
with the current version structure.
wType
Specifies the
type of data in the version resource. This member is 1 if the version resource
contains text data and 0 if the version resource contains binary data.
szKey
Contains the
Unicode string Translation or
a user-defined key string value.
Padding
Contains as
many zero words as necessary to align the Value member on a 32-bit
boundary.
Value
Specifies a
list of one or more values that are typically language identifiers.
Remarks
If you use
the Var structure to list the languages your application or DLL
supports, a suggestion is that you use the Value member to contain an
array of doubleword values indicating the language and code-page combinations
supported by this file. The high-order word of each doubleword could contain a
Microsoft language identifier and the low-order word could contain the IBM code-page
number. Either high-order or low-order word may be zero, indicating that the file
is language or code-page independent. If this block is omitted, the file will
be interpreted as language and code-page independent.
See Also