Наличие параметров в выполняемой секции во многом зависит от типа скрипта (стандартный, драйверный, расширенный). В одной заголовочной секции не может быть двух и более одноимённых параметров. Имена параметров, за исключением специальных флагов, определяют тип действий, например, запись в реестр, копирование файлов. Значения этих параметров составляют имена других, дочерних секций, содержащих адреса и имена объектов для выполнения операций. Имена дочерних секций должны даваться через запятую и знак пробела. Если имён дочерних секций несколько, они выполняются по очереди, в порядке написания. Некоторые параметры должны содержать только одну секцию. Пример выполняемой секции расширенного скрипта:
Правило: имена дочерних секций ( в этом примере они: cpf.test, cpf.tester,cpf.testing...) не должны начинаться со знака цифры (0-9) и не должны быть равны зарезервированным именам параметров, как то:
CopyFiles DelFiles AddReg DelReg UpdateInis Reboot CheckAdminRights RequiredEngine CustomDestination BeginPrompt EndPrompt ComponentName ComponentVersion PreRollBack PerUserInstall RunPreSetupCommands RunPostSetupCommands. Кроме того, имена секций не должны содержать пробелов и знаков: ",'/\?*;:^()[]
Параметр |
Возможные значения |
Определение |
Интерпретатор SETUPAPI: |
CopyFiles |
CopyFiles=Имена дочерних секций |
Копирование файлов, расположенных относительно файла скрипта в текущей директории, в поддиректориях или в cabinet-архивах в назначенные директории копирования. Более подробно в теме:
|
DelFiles |
DelFiles=Имена дочерних секций |
Удаление файлов в указанных директориях, либо относительно системной директории MS Windows. Более подробно в теме: "Копирование файлов"
|
RenFiles |
RenFiles=Имена дочерних секций |
Переименование файлов в указанных директориях, либо относительно системной директории MS Windows. Более подробно в теме: "Переименование файлов"
|
AddReg |
AddReg=Имена дочерних секций |
Добавление или замена ключей, параметров и значений системного реестра на указанные в дочерних секциях. Более подробно в теме: "Операции с системным реестром" |
DelReg |
DelReg=Имена дочерних секций |
Удаление из системного реестра ключей или параметров (не значений), указанных в дочерних секциях. Более подробно в теме: "Запись и удаление ключей реестра" |
UpdateInis |
UpdateInis=Имена дочерних секций |
Удаление или запись параметров и значений в INI-файлах, а также создание пользовательских ярлыков. Более подробно в теме: "Работа с INI-файлами" |
Интерпретатор AdvancedINF (версии 2.0 и выше): |
RequiredEngine |
RequiredEngine=SETUPAPI,"Error string" |
Проверка на наличие указанного интерпретатора в системе перед обработкой выполняемой секции; SETUPAPI - имя, "Error string" - строка выводимой ошибки в случае отсутствия интерпретатора. Если интерпретатор не найден, обработка скрипта прекращается. Проверка производится перед обработкой всех остальных параметров. |
Reboot |
Reboot=1
Reboot=0 |
Флаг перезагрузки после выполнения пакета процедур. Этот флаг может быть отменён флагом вызова скрипта (через точку входа LaunchINFSectionEx)
0 - Перезагрузка не выполняется, даже если это необходимо.
1 - Пользователю всегда выдается запрос о перезагрузке. |
CheckAdminRights NTAdmin |
CheckAdminRights=1
CheckAdminRights=0
NTAdmin=1
NTAdmin=0 |
Проверка перед выполнением на наличие администраторских привилегий текущего пользователя. Актуально только на NT-системах (MS Windows NT 4.0, 2000, XP, 2003) При 1 - производится. Если текущий пользователь в системе не имеет прав администратора, выводится ошибка и обработка скрипта прекращается. Проверка производится перед обработкой всех остальных параметров, за исключением RequiredEngine. |
CustomDestination |
CustomDestination=Имена дочерних секций |
Определение переменной путем чтения значения в системном реестре. Более подробно в теме: |
BeginPrompt |
BeginPrompt=Имя единственной дочерней секции |
Отображение начального диалога с произвольным текстом и двумя кнопками (OK и Отмена). Если пользователь выберет "Отмена", обработка скрипта будет отменена. Более подробно, тема: |
EndPrompt |
EndPrompt=Имя единственной дочерней секции |
Завершающий пакет процедур диалог, с произвольным текстом и единственной кнопкой. Более подробно, тема: "Диалоговые окна (AdvancedINF)" |
RunPreSetupCommands |
RunPreSetupCommands=Имена дочерних секций |
Выполнение списка (списков) команд до начала обработки параметров CopyFiles, DelFiles, AddReg, DelReg, UpdateInis, PerUserInstall, EndPrompt и RunPostSetupCommands, но после обработки параметров CheckAdminRights, RequiredEngine. Более подробно тема: Последовательное выполнение списка команд (AdvancedINF) |
RunPostSetupCommands |
RunPostSetupCommands=Имена дочерних секций |
Выполнение списка (списков) команд после обработки всех параметров, кроме EndPrompt. Более подробно в теме: Последовательное выполнение списка команд (AdvancedINF) |
PerUserInstall |
PerUserInstall=Имя единственной дочерней секции |
Указывает дополнительную исполнимую секцию, которая "регистрирует" программу в списке Active Setup и дает возможность единожды под каждым пользователем при следующих входах в систему выполнить любой исполнимый файл с параметрами. Более подробно в теме: "Секция Per User (Active Setup)" |
Интерпретатор AdvancedINF (версии 2.5 и выше): |
RegisterOCXs |
RegisterOCXs=Имена дочерних секций |
Регистрация "активных" библиотек. Более подробно в теме: "Регистрация и отмена регистрации библиотек (AdvpackINF)" |
UnregisterOCXs |
UnregisterOCXs=Имена дочерних секций |
Отмена регистрации "активных" библиотек. Более подробно в теме: "Регистрация и отмена регистрации библиотек (AdvpackINF)" |
Deldirs |
Deldirs=Имена дочерних секций |
Удаление директорий, указанных в дочерних секциях. |
Cleanup |
Cleanup=1
Cleanup=0 |
Очистка директорий от содержимого перед удалением директорий (DelDirs). |
NTAdmin |
NTAdmin=1
NTAdmin=0 |
То же самое, что и CheckAdminRights. |
PreRollBack |
PreRollBack=Имя другой выполняемой секции |
Реализация функции отката реестра, требуется указать выполняемую секцию, реестровые ключи операций которой будут сохранены в бинарный файл перед выполнением текущей секции. Типично - в секции инсталляции пакета указывать в качестве откатной точки секцию деинсталляции. При этом удаляются ключи и значения, установленные этим пакетом и возвращаются прежние, восстановленные из бинарного файла. |
BackupPath |
BackupPath=Директория |
Применяется вместе с параметром PreRollBack, указывает директорию (можно несуществующую), которая будет использоваться для сохранения бинарных файлов точек отката реестра. |
CatalogName |
CatalogName=имя файла лицензий |
Нет комментариев. |