Функции базы данных

Этот материал предназначен для разработчиков, которые создают собственные программы установки, и разработчиков, которые хотят узнать больше о таблицах базы данных установщика. Общие сведения об установщике см. в разделе Сведения об установщике Windows.

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

В этом разделе перечислены функции доступа к базе данных установщика по категориям.

Общие функции доступа к базе данных

Функция	Описание
MsiDatabaseCommit	Фиксирует изменения в базе данных.
MsiDatabaseGetPrimaryKeys	Возвращает имена всех столбцов первичного ключа.
MsiDatabaseIsTablePersistent	Возвращает перечисление, описывающее состояние таблицы.
MsiDatabaseOpenView	Подготавливает запрос к базе данных и создает объект представления.
MsiGetActiveDatabase	Возвращает активную базу данных для установки.
MsiViewGetColumnInfo	Возвращает имена или определения столбцов.
MsiOpenDatabase	Открывает файл базы данных для доступа к данным.
MsiViewClose	Освобождает результирующий набор для выполненного представления.
MsiViewExecute	Выполняет запрос представления и предоставляет необходимые параметры.
MsiViewFetch	Извлекает следующую последовательную запись из представления.
MsiViewGetError	Возвращает ошибку, которая произошла в функции MsiViewModify .
MsiViewModify	Обновления извлекаемой записи.

 

Функции управления базами данных

Функция	Описание
MsiCreateTransformSummaryInfo	Создает сводные сведения для существующего преобразования.
MsiDatabaseApplyTransform	Применяет преобразование к базе данных.
MsiDatabaseExport	Экспортирует таблицу из открытой базы данных в текстовый архивный файл.
MsiDatabaseGenerateTransform	Создает файл преобразования различий между двумя базами данных.
MsiDatabaseImport	Импортирует таблицу архива текста установщика в открытую базу данных.
MsiDatabaseMerge	Объединяет две базы данных.
MsiGetDatabaseState	Возвращает состояние базы данных.

 

Функции обработки записей

Функция	Описание
MsiCreateRecord	Создает объект записи с указанным количеством полей.
MsiFormatRecord	Форматирует данные и свойства поля записи с помощью строки форматирования.
MsiRecordClearData	Задает для всех полей в записи значение NULL.
MsiRecordDataSize	Возвращает длину поля записи.
MsiRecordGetFieldCount	Возвращает число полей в записи.
MsiRecordGetInteger	Возвращает целочисленное значение из поля записи.
MsiRecordGetString	Возвращает строковое значение поля записи.
MsiRecordIsNull	Сообщает, имеет ли поле записи значение NULL.
MsiRecordReadStream	Считывает байты из поля потока записей в буфер.
MsiRecordSetInteger	Задает для поля записи целочисленное поле.
MsiRecordSetStream	Задает поле потока записей из файла.
MsiRecordSetString	Копирует строку в указанное поле.

 

Функции свойств сводной информации

Функция	Описание
MsiGetSummaryInformation	Получает дескриптор для потока сводной информации базы данных установщика.
MsiSummaryInfoGetProperty	Возвращает одно свойство из сводной информации.
MsiSummaryInfoGetPropertyCount	Возвращает количество свойств в потоке сводной информации.
MsiSummaryInfoPersist	Записывает измененные сводные сведения обратно в поток сводной информации.
MsiSummaryInfoSetProperty	Задает одно свойство сводной информации.

 

Функции доступа к состоянию установщика

Функция	Описание
MsiGetLanguage	Возвращает числовой язык текущей установки.
MsiGetLastErrorRecord	Возвращает запись об ошибке, в последнюю очередь возвращенную для вызывающего процесса.
MsiGetMode	Возвращает одно из логических состояний внутренней установки.
MsiGetProperty	Возвращает значение свойства установщика.
MsiSetProperty	Задает значение свойства установки.
MsiSetMode	Задает логическое состояние внутреннего обработчика.

 

Функции действий установщика

Функция	Описание
MsiDoAction	Выполняет встроенное действие, настраиваемое действие или действие мастера пользовательского интерфейса.
MsiEvaluateCondition	Вычисляет условное выражение, содержащее имена и значения свойств.
MsiProcessMessage	Отправляет запись об ошибке в установщик для обработки.
MsiSequence	Выполняет последовательность действий.

 

Функции расположения установщика

Функция	Описание
MsiGetSourcePath	Возвращает полный исходный путь к папке в таблице Каталог.
MsiGetTargetPath	Возвращает полный целевой путь к папке в таблице Каталог.
MsiSetTargetPath	Задает полный целевой путь к папке в таблице Каталог.

 

Функции выбора установщика

Функция	Описание
MsiEnumComponentCosts	Перечисляет место на диске, необходимое для установки компонента.
MsiGetComponentState	Получает состояние компонента.
MsiGetFeatureCost	Возвращает дисковое пространство, необходимое компоненту.
MsiGetFeatureState	Возвращает состояние компонента.
MsiGetFeatureValidStates	Возвращает допустимое состояние установки.
MsiSetComponentState	Задает для компонента указанное состояние.
MsiSetFeatureAttributes	Изменяет атрибуты компонента по умолчанию во время выполнения.
MsiSetFeatureState	Задает для компонента указанное состояние.
MsiSetInstallLevel	Задает уровень установки полной установки продукта.
MsiVerifyDiskSpace	Проверяет наличие достаточного места на диске.

 

Функции пользовательского интерфейса

Функция	Описание
MsiEnableUIPreview	Включает режим предварительного просмотра пользовательского интерфейса.
MsiPreviewBillboard	Отображает рекламный баннер с элементом управления host в отображаемом диалоговом окне.
MsiPreviewDialog	Отображает диалоговое окно как немодерное и неактивное.

 

Все функции поддерживают вызовы ANSI и Юникода. Чтобы использовать эти функции, включите MsiQuery.h и свяжите с msi.lib.

Функции установки

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