Тип настраиваемого действия 17
Это настраиваемое действие вызывает библиотеку динамической компоновки (DLL), написанную на языке C или C++.
Источник
Библиотека DLL устанавливается вместе с приложением во время текущего сеанса. Поле Source таблицы CustomAction содержит ключ к таблице File. Расположение кода настраиваемого действия определяется разрешением целевого пути к этому файлу; Поэтому это настраиваемое действие должно вызываться после установки этого файла и перед его удалением.
Значение типа
Добавьте следующее значение в столбец Type таблицы CustomAction , чтобы указать базовый числовой тип.
| Константы | Шестнадцатеричный | Decimal |
|---|---|---|
| msidbCustomActionTypeDll + msidbCustomActionTypeSourceFile | 0x011 | 17 |
Назначение
Библиотека DLL вызывается через точку входа с именем в поле Target таблицы CustomAction, передавая один аргумент, который является дескриптором в текущий сеанс установки. Имя точки входа, указанное в таблице, должно совпадать с именем, экспортируемым из библиотеки DLL. Обратите внимание, что если функция входа не указана в . DEF-файл или по спецификации компоновщика /EXPORT: имя может иметь символ подчеркивания в начале и суффикс "@4". Вызываемая функция должна указывать соглашение о вызовах __stdcall.
Параметры обработки возврата
Включите необязательные биты флагов в столбец Type таблицы CustomAction , чтобы указать параметры обработки возвращаемых значений. Описание параметров и значений см. в разделе Параметры обработки возврата пользовательского действия.
Параметры планирования выполнения
Включите необязательные биты флагов в столбец Тип таблицы CustomAction , чтобы указать параметры планирования выполнения. Эти параметры управляют множественным выполнением пользовательских действий. Описание параметров см. в разделе Параметры планирования выполнения настраиваемых действий.
Параметры выполнения In-Script
Включите необязательные биты флагов в столбец Тип таблицы CustomAction , чтобы указать параметр выполнения в скрипте. Эти параметры копируют код действия в скрипт выполнения, отката или фиксации. Описание параметров см. в разделе Параметры выполнения пользовательского действия In-Script.
Возвращаемые значения
См . раздел Возвращаемые значения настраиваемого действия.
Комментарии
Для настраиваемого действия, вызывающего библиотеку динамической компоновки (DLL), требуется дескриптор сеанса установки. Если это также отложенное пользовательское действие выполнения, сеанс может перестать существовать во время выполнения скрипта установки. Сведения о том, как пользовательское действие этого типа может получить сведения о контексте, см. в разделе Получение сведений о контексте для пользовательских действий отложенного выполнения.
Пользовательские действия выполняются в отдельном потоке и могут иметь ограниченный доступ к системе. Пользовательские действия, выполняемые асинхронно, блокируют поток main при завершении текущей последовательности или сеанса установки до тех пор, пока они не вернутся.
Пользовательские действия, которые ссылались на установленный файл в качестве источника, например тип пользовательского действия 17 (DLL), должны соответствовать следующим ограничениям последовательности:
- Настраиваемое действие должно быть упорядочено после действия CostFinalize. Это позволяет пользовательскому действию разрешить путь, необходимый для поиска библиотеки DLL.
- Если исходный файл еще не установлен на компьютере, отложенные (в скрипте) пользовательские действия этого типа должны быть последовательно установлены после действия InstallFiles.
- Если исходный файл еще не установлен на компьютере, не отложенные пользовательские действия этого типа должны быть последовательно установлены после действия InstallFinalize.
Связанные темы