Var

Article
06/30/2006

This structure depicts the organization of data in a file-version resource. It typically contains a list of language and code page identifier pairs that the version of the application or dynamic-link library (DLL) supports.

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 a Software Development Kit (SDK) for a Windows CE operating system.

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

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	3.0 and later

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

Last updated on Tuesday, July 13, 2004

Var

Additional resources