Структура строки

Представляет организацию данных в ресурсе версии файла. Он содержит строку, описывающую конкретный аспект файла, например версию файла, уведомления об авторских правах или товарные знаки.

Синтаксис

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

Члены

wLength

Тип: WORD

Длина (в байтах) этой структуры String .

wValueLength

Тип: WORD

Размер элемента Value , в словах.

wType

Тип: WORD

Тип данных в ресурсе версии. Этот элемент равен 1, если ресурс версии содержит текстовые данные, и 0, если ресурс версии содержит двоичные данные.

szKey

Тип: WCHAR

Произвольная строка Юникода. Элемент szKey может иметь одно или несколько следующих значений. Эти значения являются только рекомендациями.

Комментарии

Элемент Value содержит любые дополнительные сведения, которые должны отображаться в целях диагностики. Эта строка может иметь произвольную длину.

Companyname

Элемент Value идентифицирует компанию, создающую файл. Например, Microsoft Corporation или Standard Microsystems Corporation, Inc.

Описание файла

Элемент Value описывает файл таким образом, чтобы его можно было представить пользователям. Эта строка может отображаться в списке, когда пользователь выбирает файлы для установки. Например, "Драйвер клавиатуры для клавиатур в стиле AT" или "Microsoft Word для Windows".

FileVersion

Элемент Value определяет версию этого файла. Например, значением может быть "3.00A" или "5.00.RC2".

Внутреннее имя

Элемент Value определяет внутреннее имя файла, если оно существует. Например, эта строка может содержать имя модуля для библиотеки DLL, имя виртуального устройства Windows или имя устройства для драйвера устройства MS-DOS.

LegalCopyright

Участник Value описывает все уведомления об авторских правах, товарные знаки и зарегистрированные товарные знаки, которые применяются к файлу. Это должен быть полный текст всех уведомлений, допустимых символов, сроки действия прав, номера товарных знаков и так далее. На английском языке эта строка должна иметь формат "Copyright Microsoft Corp. 1990 1994".

LegalTrademarks

Участник Value описывает все товарные знаки и зарегистрированные товарные знаки, которые применяются к файлу. Это должен быть полный текст всех уведомлений, допустимых символов, номера товарных знаков и так далее. На русском языке эта строка должна быть в формате "Windows является товарным знаком корпорации Майкрософт".

OriginalFilename

Элемент Value определяет исходное имя файла, не включая путь. Это позволяет приложению определить, был ли файл переименован пользователем. Это имя может не иметь формат MS-DOS 8.3, если файл относится к файловой системе, отличной от FAT.

PrivateBuild

Элемент Value описывает, кем, где и почему была создана эта закрытая версия файла. Эта строка должна присутствовать, только если флаг VS_FF_PRIVATEBUILD установлен в элементе dwFileFlagsструктуры VS_FIXEDFILEINFO . Например, значением может быть "Built by OSCAR on \OSCAR2".

Productname

Элемент Value определяет имя продукта, с которым распространяется этот файл. Например, эта строка может быть "Microsoft Windows".

ProductVersion

Элемент Value определяет версию продукта, с которым распространяется этот файл. Например, значением может быть "3.00A" или "5.00.RC2".

SpecialBuild

Элемент Value описывает, чем эта версия файла отличается от обычной версии. Эта запись должна присутствовать, только если флаг VS_FF_SPECIALBUILD установлен в элементе dwFileFlags структуры VS_FIXEDFILEINFO . Например, значением может быть "Частная сборка для Оливетти, решая проблемы с мышью на компьютерах M250 и M250E".

Заполнение

Тип: WORD

Столько нулевых слов, сколько необходимо для выравнивания элемента Value на 32-разрядной границе.

Значение

Тип: WORD

Строка с нулем. Дополнительные сведения см. в описании элемента szKey .

Комментарии

Эта структура не является истинной структурой языка C, так как она содержит члены переменной длины. Эта структура была создана исключительно для отображения организации данных в ресурсе версии и не отображается ни в одном из файлов заголовков, поставляемых вместе с пакетом средств разработки программного обеспечения (SDK) для Windows.

Структура String может иметь значение szKey, например CompanyName, и значение Microsoft Corporation. Другая структура String с тем же значением szKey может содержать значение "Microsoft GmbH". Это может произойти, если вторая структура String была связана со структурой StringTable , значение szKey которой равно 040704b0, то есть немецкий/Юникод.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]

См. также раздел

Справочные материалы

StringTable

VS_FIXEDFILEINFO

StringFileInfo

VS_VERSIONINFO

Основные понятия

Сведения о версии