Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure depicts the organization of data in a file-version resource. It contains language and code page formatting information for the strings specified by the Childrenmember. A code page is an ordered character set.

This structure is not a true C-language structure because it contains variable-length members.

Syntax 

typedef struct StringTable {
  WORD 
wLength;
  WORD 
wValueLength;
  WORD 
wType;
  WCHAR 
szKey[];
  WORD 
Padding[];
  String 
Children[];
} StringTable;

Members

wLength

Length, in bytes, of this StringTablestructure, including all structures indicated by the Childrenmember.

wValueLength

Always set to zero.

wType

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

Specifies an 8-digit hexadecimal number stored as a Unicode string. The four most significant digits represent the language identifier. The four least significant digits represent the code page for which the data is formatted.

Each Microsoft Standard Language identifier contains two parts: the low-order 10 bits specify the major language, and the high-order 6 bits specify the sublanguage. For a table of valid identifiers, see National Language Support (NLS) Locale Identifiers.

Padding

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

Children

Array of one or more Stringstructures.

Remarks

The Childrenmember of the StringFileInfostructure contains at least one StringTablestructure.

Set the code page portion of the szKeymember to the hexadecimal value 0x04b0 to indicate the Unicode code page, or to the hexadecimal value of the code page that is appropriate for the language component. After you choose the value for the code page you should continue to use the same value in later revisions to the file.

An executable file or DLL that supports multiple languages should have a version resource for each language, rather than a single version resource that contains strings in several languages. However, if you use the Varstructure to list the languages that your application supports, the number of StringTablestructures in the version resource is directly related to the number of language/code page identifier pairs in the Valuemember of the Varstructure. 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 an SDK for a Windows Embedded CE OS.

Requirements

Header Developer Implemented
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also