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

Этот материал предназначен для разработчиков, которые пишут собственные программы установки и разработчики, которые хотят узнать больше о таблицах базы данных установщика. Общие сведения о установщике см. в разделе о установщике 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	Отображает рекламный щит с элементом управления узлом в отображаемом диалоговом окне.
MsiPreviewDialog	Отображает диалоговое окно как безрежимное и неактивное.

 

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

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

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