On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

String

The String structure depicts the organization of data in a file-version resource. 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 the Microsoft® Win32® Software Development Kit (SDK).

The String structure contains a string that describes a specific aspect of a file.

String {
WORD wLength;
WORD wValueLength;
WORD wType;
WCHAR szKey[];
WORD Padding[];
String Value[];
} String;

Members

wLength

Specifies the length of the version resource.

wValueLength

Specifies the length of the Value member in the current VS_VERSION_INFO structure. This value is zero if there is no Value member associated with the current version structure.

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

Specifies an arbitrary Unicode string. The szKey member can be one or more of the following values. These values are guidelines only.

String Meaning
Comments The Value member contains any additional information that should be displayed for diagnostic purposes. This string can be an arbitrary length.
CompanyName The Value member identifies the company that produced the file. For example, "Microsoft Corporation" or "Standard Microsystems Corporation, Inc."
FileDescription The Value member describes the file in such a way that it can be presented to users. This string may be presented in a list box when the user is choosing files to install. For example, "Keyboard driver for AT-style keyboards" or "Microsoft Word for Windows".
FileVersion The Value member identifies the version of this file. For example, Value could be "3.00A" or "5.00.RC2".
InternalName The Value member identifies the file's internal name, if one exists. For example, this string would contain the module name for Windows dynamic-link libraries (DLLs), a virtual device name for Windows virtual devices, or a device name for MS-DOS device drivers.
LegalCopyright The Value member describes all copyright notices, trademarks, and registered trademarks that apply to the file. This should include the full text of all notices, legal symbols, copyright dates, trademark numbers, and so on. In English, this string should be in the format "Copyright Microsoft Corp. 1990-1994".
LegalTrademarks The Value member describes all trademarks and registered trademarks that apply to the file. This should include the full text of all notices, legal symbols, trademark numbers, and so on. In English, this string should be in the format "Windows is a trademark of Microsoft Corporation".
OriginalFilename The Value member identifies the original name of the file, not including a path. This enables an application to determine whether a file has been renamed by a user. This name may not be MS-DOS 8.3-format if the file is specific to a non-FAT file system.
PrivateBuild The Value member describes by whom, where, and why this private version of the file was built. This string should only be present if the VS_FF_PRIVATEBUILD flag is set in the dwFileFlags member of the VS_FIXEDFILEINFO structure. For example, Value could be "Built by OSCAR on \OSCAR2".
ProductName The Value member identifies the name of the product with which this file is distributed. For example, this string could be "Microsoft Windows".
ProductVersion The Value member identifies the version of the product with which this file is distributed. For example, Value could be "3.00A" or "5.00.RC2".
SpecialBuild The Value member describes how this version of the file differs from the normal version. This entry should only be present if the VS_FF_SPECIALBUILD flag is set in the dwFileFlags member of the VS_FIXEDFILEINFO structure. For example, Value could be "Private build for Olivetti solving mouse problems on M250 and M250E computers".

Padding

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

Value

Specifies a zero-terminated string. See the szKey member description for more information.

Remarks

A String structure may have an szKey value of, for example, "CompanyName" and a Value of "Microsoft Corporation". Another String structure with the same szKey value could contain a Value of "Microsoft GmbH". This might occur if the second String structure were associated with a StringTable structure whose szKey value is 040704b0 ѕ that is, German/Unicode. The code page can be set to 1200 (decimal) or 0x04b0 (hexadecimal) to indicate Unicode. The code page can also be set to the value 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.

See Also

StringTable, VS_FIXEDFILEINFO, VS_VERSION_INFO

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Строка

Структура Строки изображает организацию данных в файловой версии ресурса. Эта структура не является структурой истины C-language поскольку это содержит переменная длина участников. Эта структура создавалась исключительно, чтобы изображать организацию данных в ресурсе версии и не появляться в любом из файлов заголовка отправленных Microsoft Win32 Программный Комплект Разработки (SDK).

Структура Строки содержит строку, которая описывает специфический аспект файла.

Строка { WORD wLength;
СЛОВО wValueLength;
СЛОВО wType;
WCHAR szKey[];
СЛОВО, заполняющее[];
Величина Строки[];
} Строка;

Участники

wLength

Определяет длину ресурса версии.

wValueLength

Определяет длину элемента Величины в текущей структуре VS_VERSION_INFO. Эта величина является нулем если нет элемента Величины связывался бы текущей структурой версии.

wType

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

szKey

Определяет произвольную строку Уникода. Элемент szKey может быть одно или более из следующего величин. Эти величины являются руководящими принципами только.

Значение Строки
Комментирует элемент Величины содержит любую дополнительную информацию, которая должна быть отображена для диагностических целей. Эта строка может быть произвольной длиной.
CompanyName ЭЛЕМЕНТ Величины идентифицирует компанию, которая производила файл. Например, "Корпорация Микрософт" или "Standard Microsystems Corporation, Inc." FileDescription ЭЛЕМЕНТ Величины описывает файл таким образом, чтобы может быть представлено пользователям. Эта строка может быть представлена в блоке списка когда пользователь решает, чтобы устанавливаться. Например, "Клавишный драйвер для НА-клавиатуре стиля" или "Слово Микрософт для Окна".
FileVersion ЭЛЕМЕНТ Величины идентифицирует версию этого файла. Например, Величина могла быть "3.00A" или "5.00.RC2".
InternalName ЭЛЕМЕНТ Величины идентифицирует файловое внутреннее имя, если один существует. Например, эта строка должна содержать модуль называть в честь динамической связи библиотек Windows (DLLs), виртуальное устройство называет в честь виртуальных устройств Windows, или устройство называет в честь драйверов устройства МС-DOS.
LegalCopyright ЭЛЕМЕНТ Величины описывает все авторские уведомления, торговые марки, и зарегистрированные фирменные знаки, которые относятся к файлу. Это должно включить полный текст всех уведомлений, юридических символов, авторских дат, номера торговой марки, и так далее. В Английском, эта строка должна быть в формате "Авторского права Микрософт Corp. 1990-1994".
LegalTrademarks ЭЛЕМЕНТ Величины описывает все торговые марки и зарегистрированные фирменные знаки, которые относятся к файлу. Это должно включить полный текст всех уведомлений, юридических символов, номера торговой марки, и так далее. В Английском, эта строка должна быть в формате "Windows - торговая марка Корпорации Микрософт".
OriginalFilename ЭЛЕМЕНТ Величины идентифицирует оригинальное имя файла, не включая путь. Это позволяет приложение, чтобы определять переименован файл пользователем. Это имя не может быть форматом МС-DOS 8.3-если файл характерный для не-файловой системы ЖИРА.
PrivateBuild ЭЛЕМЕНТ Величины описывается, которым, где, и почему эта частная версия файла была создана. Эта строка должна только присутствовать если флаг VS_FF_PRIVATEBUILD установлен в элементе dwFileFlags структуры VS_FIXEDFILEINFO. Например, Величина могла "Создан OSCAR на \OSCAR2".
ProductName ЭЛЕМЕНТ Величины идентифицирует имя продукта с которым этот файл распространен. Например, эта строка могла быть "Microsoft Windows".
ProductVersion ЭЛЕМЕНТ Величины идентифицирует версию продукта с которым этот файл распространен. Например, Величина могла быть "3.00A" или "5.00.RC2".
SpecialBuild ЭЛЕМЕНТ Величины описывается, как эта версия файла отличается от нормальной версии. Этот вход должен только присутствовать если флаг VS_FF_SPECIALBUILD установлен в элементе dwFileFlags структуры VS_FIXEDFILEINFO. Например, Величина могла быть "Частной формироваться для Olivetti, решающий проблемы мыши в M250 и компьютерах M250E".

Заполнение

Содержит столько нулевых слова сколько необходимый выравнивать элемент Величины на 32- битовой границе.

Величина

Определяет расторгнутую нулевую строку. Смотри описание элемента szKey более подробно.

Замечания

Структура Строки может иметь величину szKey, например, "CompanyName" и Величина "Корпорации Микрософт". Другая структура Строки с той же величиной szKey могла бы содержать Величину "Микрософт GmbH". Это могло произойти если вторая структура Строки была связана структурой StringTable чьей величины szKey - 040704b0 U то есть, German/Unicode. Кодовая страница может быть установлена на 1200 (десятичный) или 0x04b0 (шестнадцатеричный), чтобы указывать Уникод. Кодовая страница может также установлена в величину, которая подходящая для языкового компонента. После того, как Вы выберете величину для кодовой страницы, которая Вы должны продолжить использовать ту же величину в последующих исправлениях в файл.

Смотри Также

StringTable, VS_FIXEDFILEINFO, VS_VERSION_INFO

Используются технологии uCoz