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

  • Статья

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

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

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