字符串结构

表示文件版本资源中的数据组织。 它包含描述文件的特定方面的字符串,例如文件的版本、其版权声明或其商标。

语法

typedef struct {
  WORD  wLength;
  WORD  wValueLength;
  WORD  wType;
  WCHAR szKey;
  WORD  Padding;
  WORD  Value;
} String;

成员

wLength

类型: WORD

字符串 结构的长度(以字节为单位)。

wValueLength

类型: WORD

Value 成员的大小(以字为单位)。

wType

类型: WORD

版本资源中的数据类型。 如果版本资源包含文本数据,则此成员为 1;如果版本资源包含二进制数据,则为 0。

szKey

类型: WCHAR

任意 Unicode 字符串。 szKey 成员可以是以下一个或多个值。 这些值仅是准则。

评论

Value 成员包含应出于诊断目的而显示的任何其他信息。 此字符串可以是任意长度。

CompanyName

Value 成员标识生成该文件的公司。 例如,“Microsoft Corporation”或“Standard Microsystems Corporation, Inc.

FileDescription

Value 成员以可向用户呈现的方式描述文件。 当用户选择要安装的文件时,此字符串可能会显示在列表框中。 例如,“AT 样式键盘的键盘驱动程序”或“适用于 Windows 的 Microsoft Word”。

FileVersion

Value 成员标识此文件的版本。 例如, 可以是“3.00A”或“5.00.RC2”。

InternalName

Value 成员标识文件的内部名称(如果存在)。 例如,此字符串可以包含 DLL 的模块名称、Windows 虚拟设备的虚拟设备名称或 MS-DOS 设备驱动程序的设备名称。

LegalCopyright

Value 成员描述适用于文件的所有版权声明、商标和注册商标。 这应包括所有声明的完整文本、合法符号、版权日期、商标号等。 在英语中,此字符串的格式应为“版权所有 Microsoft Corp. 1990 1994”。

LegalTrademarks

Value 成员描述适用于文件的所有商标和注册商标。 这应包括所有声明的完整文本、合法符号、商标号等。 在英语中,此字符串应采用格式”Windows is a trademark of Microsoft Corporation”。

OriginalFilename

Value 成员标识文件的原始名称,不包括路径。 这使应用程序能够确定文件是否已由用户重命名。 如果文件特定于非 FAT 文件系统,则此名称可能不是 MS-DOS 8.3 格式。

PrivateBuild

Value 成员描述生成此专用版本的文件的人员、地点和原因。 仅当VS_FIXEDFILEINFO结构的dwFileFlags 成员中设置了VS_FF_PRIVATEBUILD标志时,此字符串才应存在。 例如, 可以是“由 OSCAR 在 \OSCAR2 上生成”。

ProductName

Value 成员标识用于分发此文件的产品的名称。 例如,此字符串可以是“Microsoft Windows”。

ProductVersion

Value 成员标识用于分发此文件的产品的版本。 例如, 可以是“3.00A”或“5.00.RC2”。

SpecialBuild

Value 成员描述此版本的文件与普通版本有何不同。 仅当VS_FIXEDFILEINFO结构的 dwFileFlags 成员中设置了VS_FF_SPECIALBUILD标志时,才应存在条目。 例如, 可以是“Olivetti 解决 M250 和 M250E 计算机上的鼠标问题的专用版本”。

填充

类型: WORD

在 32 位边界上对齐 Value 成员所需的任意零个单词。

类型: WORD

以零结尾的字符串。 有关详细信息,请参阅 szKey 成员说明。

备注

此结构不是真正的 C 语言结构,因为它包含可变长度的成员。 此结构仅用于描述版本资源中的数据组织,不显示在 Windows 软件开发工具包 (SDK) 附带的任何头文件中。

字符串结构可能具有 szKey 值,例如,“CompanyName”和“Microsoft Corporation”的值。 具有相同 szKey 值的另一个 String 结构可能包含“Microsoft GmbH”的值。 如果第二个 String 结构与 szKey 值为 040704b0(即德语/Unicode)的 StringTable 结构相关联,则可能会出现这种情况。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]

另请参阅

引用

StringTable

VS_FIXEDFILEINFO

StringFileInfo

VS_VERSIONINFO

概念性

版本信息