Тип настраиваемого действия 1

Это настраиваемое действие вызывает библиотеку динамической компоновки (DLL), написанную на языке C или C++.

Источник

Библиотека DLL создается из временного двоичного потока. Поле Source таблицы CustomAction содержит ключ к таблице Binary.

Столбец Данные в таблице Binary содержит потоковые данные. Для каждой строки выделяется отдельный поток. Новые двоичные данные можно вставить из файла с помощью MsiRecordSetStream и MsiViewModify , чтобы вставить запись в таблицу. При вызове настраиваемого действия потоковые данные копируются во временный файл, который затем обрабатывается в зависимости от типа настраиваемого действия.

Значение типа

Включите следующие биты флагов в столбец Тип таблицы CustomAction , чтобы указать базовый числовой тип.

Константы	Шестнадцатеричный	Decimal
msidbCustomActionTypeDll + msidbCustomActionTypeBinaryData	0x001	1

 

Назначение

Библиотека DLL вызывается через точку входа в поле Target таблицы CustomAction, передавая один аргумент, который является дескриптором, в текущий сеанс установки. Имя точки входа, указанное в таблице, должно совпадать с именем, экспортируемым из библиотеки DLL. Обратите внимание, что, если функция входа не указана в . DEF-файл или спецификация компоновщика /EXPORT: имя может иметь символ подчеркивания в начале и суффикс "@4". Вызываемая функция должна указывать соглашение о вызовах __stdcall.

Параметры обработки возврата

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

Параметры планирования выполнения

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

Параметры выполнения In-Script

Включите необязательные биты флагов в столбец Тип таблицы CustomAction , чтобы указать параметр выполнения в скрипте. Эти параметры копируют код действия в скрипт выполнения, отката или фиксации. Описание параметров см. в разделе Параметры выполнения пользовательского действия In-Script.

Возвращаемые значения

См . раздел Возвращаемые значения настраиваемых действий.

Комментарии

Для настраиваемого действия, вызывающего библиотеку динамической компоновки (DLL), требуется дескриптор для сеанса установки. Если это также настраиваемое действие отложенного выполнения, сеанс может больше не существовать во время выполнения сценария установки. Сведения о том, как пользовательское действие этого типа может получить сведения о контексте, см. в разделе Получение сведений о контексте для пользовательских действий отложенного выполнения.

При экспорте таблицы базы данных каждый поток записывается как отдельный файл во вложенную папку с именем таблицы, используя первичный ключ в качестве имени файла (столбец Name для двоичной таблицы) с расширением по умолчанию ".ibd". Имя должно использовать формат 8.3, если файловая система или система управления версиями не поддерживают длинные имена файлов. Постоянный архивный файл заменяет потоковые данные именем файла, чтобы их можно было найти при импорте таблицы.

Связанные темы

Custom_Actions

Библиотеки динамической компоновки

Получение сведений о контексте для пользовательских действий с отложенным выполнением