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 Platform Software Development Kit (SDK).

The Var structure typically contains a list of language and code page identifier pairs that the version of the application or dynamic-link library (DLL) supports.

Var { 
    WORD  wLength; 
    WORD  wValueLength; 
    WORD  wType; 
    WCHAR szKey[]; 
    WORD  Padding[]; 
    DWORD Value[]; 
}; 
 

Members

wLength

Specifies the length, in bytes, of the Var structure.

wValueLength

Specifies the length, in bytes, of the Value member.

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".

Padding

Contains as many zero words as necessary to align the Value member on a 32-bit boundary.

Value

Specifies an array of one or more values that are language and code page identifier pairs. For additional information, see the following Remarks section.

Remarks

If you use the Var structure to list the languages your application or DLL supports instead of using multiple version resources, use the Value member to contain an array of DWORD values indicating the language and code page combinations supported by this file. The low-order word of each DWORD must contain a Microsoft language identifier, and the high-order word must contain the IBM® code page number. Either high-order or low-order word can be zero, indicating that the file is language or code page independent. If the Var structure is omitted, the file will be interpreted as both language and code page independent.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.

See Also

File Installation Library Overview, File Installation Library Structures, VarFileInfo, StringFileInfo, StringTable, VS_VERSIONINFO