Таблица файлов

Таблица файлов содержит полный список исходных файлов с различными атрибутами, упорядоченными по уникальному нелокализованным идентификатору. Файлы могут храниться на исходном носителе в виде отдельных файлов или сжиматься в cab-файле. Дополнительные сведения см. в разделе Использование шкафов и сжатых источников.

Таблица файлов содержит следующие столбцы.

Столбцы

Файл

Нелокализованный маркер, который однозначно идентифицирует файл. Это поле не учитывает регистр. Не назначайте идентификаторы разным файлам, которые отличаются только их регистром.

Компонент_

Внешний ключ в первом столбце таблицы компонентов. Это поле идентифицирует компонент, управляющий файлом.

Имени файла

Имя файла, используемое для установки. Имя может быть локализовано.

Так как на некоторых веб-серверах учитывается регистр, FileName должно точно соответствовать регистру исходных файлов, чтобы обеспечить поддержку загрузки из Интернета.

FileSize

Размер файла в байтах. Это должно быть не отрицательное число.

Версия

Это поле является строкой версии для файла с управлением версиями. Это поле пусто для файлов без версий. Версия файла, введенная в этом поле, должна совпадать с версией файла, входящего в пакет установки.

В поле Версия также можно задать первичный ключ другой записи в таблице File. Затем указанный файл определяет логику управления версиями для этого файла. Дополнительные сведения см. в разделе Файлы-компаньоны. Обратите внимание, что если этот файл является ключевым путем для его компонента, он не должен указываться в качестве файла-компаньона.

Язык

Список идентификаторов десятичных языков, разделенных запятыми.

Файлы шрифтов не должны создаваться с идентификатором языка, так как шрифты не имеют внедренного ресурса идентификатора языка. Таким образом, этот столбец следует оставить null для файлов шрифтов.

Атрибуты

Целое число, содержащее битовые флаги, представляющие атрибуты файла.

В следующей таблице показано определение битового поля.

Константа	Шестнадцатеричный	Decimal	Описание
msidbFileAttributesReadOnly	0x000001	1	Только для чтения
msidbFileAttributesHidden	0x000002	2	Скрытый
msidbFileAttributesSystem	0x000004	4	Система
msidbFileAttributesVital	0x000200	512	Файл имеет жизненно важное значение для точной работы компонента, к которому он принадлежит. Если установка файла с атрибутом msidbFileAttributesVital завершается сбоем, установка останавливается и выполняется откат. В этом случае установщик отображает диалоговое окно без кнопки Пропустить. Если этот атрибут не задан и установка файла завершается сбоем, установщик отображает диалоговое окно с кнопкой Пропустить. В этом случае пользователь может проигнорировать ошибку, чтобы установить файл и продолжить.
msidbFileAttributesChecksum	0x000400	1024	Файл содержит допустимую контрольную сумму. Для восстановления поврежденного файла требуется контрольная сумма.
msidbFileAttributesPatchAdded	0x001000	4096	Этот бит должен быть добавлен только исправлением и только в том случае, если файл добавляется исправлением.
msidbFileAttributesNoncompressed	0x002000	8192	Тип источника файла не сжат. Если задано значение , игнорируйте свойство сводки Word Count. Если ни msidbFileAttributesNoncompressed ни msidbFileAttributesCompressed, ни msidbFileAttributesCompressed, состояние сжатия файла задается свойством сводки Word Count. Не устанавливайте msidbFileAttributesNoncompressed и msidbFileAttributesCompressed.
msidbFileAttributesCompressed	0x004000	16384	Тип источника файла сжимается. Если задано значение , игнорируйте свойство сводки Word Count. Если ни msidbFileAttributesNoncompressed ни msidbFileAttributesCompressed, ни msidbFileAttributesCompressed, состояние сжатия файла задается свойством сводки Word Count. Не устанавливайте msidbFileAttributesNoncompressed и msidbFileAttributesCompressed.

 

Если задан бит msidbFileAttributesVital в столбце Атрибуты и для установки выбран компонент, к которому принадлежит файл, то установщик должен иметь возможность установить этот файл, чтобы установка была успешно завершена. Если установщику не удается установить файл по какой-либо причине (например, если исходный файл не может находиться в исходном образе), появится диалоговое окно с сообщением об ошибке с параметрами "Повторить" или "Отмена". Для файла, в котором не задан msidbFileAttributesVital , в случае ошибки установки будут выбраны параметры "Abort", "Retry" и "Ignore" (т. е. пользователь будет иметь возможность успешно завершить установку без установки этого файла).

Бит msidbFileAttributesChecksum в столбце Attributes должен быть задан для каждого исполняемого файла в установке, имеющего допустимую контрольную сумму , хранящуюся в заголовке переносимого исполняемого файла (PE). Во время переустановки будут проверяться только те файлы, для которых задан этот бит. Дополнительные сведения см. в разделе REINSTALLMODE.

Последовательности

Последовательность размещения этого файла на изображениях мультимедиа. Этот порядок должен соответствовать порядку файлов в шкафу, если файлы сжаты. Целые числа в этом поле должны быть равны или больше 1.

Порядковые номера в столбце Последовательность используются для указания порядка установки файлов и исходного носителя, на котором находится файл (в сочетании с таблицей мультимедиа). Например, предположим, что файл имеет порядковый номер 92. Чтобы определить исходный диск, на котором находится этот файл, найдите в таблице Media запись с наименьшим значением последней последовательности, которое больше 92.

Хотя сжатым файлам назначаются внутренние порядковые номера в шкафах, эти абсолютные числа не должны соответствовать порядковому номеру в таблице File. Однако важно, чтобы последовательность файлов в таблице File была идентична последовательности файлов в шкафах.

Для файлов, которые не сжаты, порядковые номера не должны быть уникальными. Например, если все файлы распаковываются и находятся на одном диске, можно присвоить всем файлам одинаковый порядковый номер.

Максимальное ограничение — 32767 файлов. Сведения о создании пакета установщика Windows с дополнительными файлами см. в статье Создание большого пакета.

Комментарии

Действия InstallFiles и RemoveFiles в таблицах последовательностей обрабатывают сведения в этой таблице. Сведения об использовании таблиц последовательностей см. в статье Использование таблицы последовательностей.

Таблица изначально создается из списка файлов, но если используется сжатие шкафа, таблица создается на основе выходных данных модуля сжатия. Дополнительные сведения см. в разделе Файлы кабинета.

Чтобы переместить существующий файл на компьютере пользователя во время установки, используйте действие MoveFiles и таблицу MoveFile. Чтобы установить файл в нескольких расположениях, используйте действие DuplicateFiles и таблицу DuplicateFile.

В следующей таблице перечислены возможные сочетания значений в столбцах Версия и Язык. Дополнительные сведения см. в разделе Правила управления версиями файлов.

Дополнительные сведения см. в разделах Таблица MsiLockPermissionsEx и Таблица LockPermissions.

Проверка

ICE02
ICE03
ICE04
ICE06
ICE18
ICE30
ICE32
ICE35
ICE39
ICE42
ICE45
ICE50
ICE51
ICE54
ICE55
ICE57
ICE59
ICE60
ICE67
ICE69
ICE76
ICE91