字符串结构

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

语法

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 样式键盘的键盘驱动程序”或“Microsoft Word for Windows”。

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标志时,才应存在此条目。 例如, 可以是“用于在 M250 和 M250E 计算机上解决鼠标问题的奥利弗蒂专用生成”。

填充

类型: WORD

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

类型: WORD

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

注解

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

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

要求

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

另请参阅

引用

StringTable

VS_FIXEDFILEINFO

StringFileInfo

VS_VERSIONINFO

概念性

版本信息