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

VarFileInfo, VS_VERSION_INFO