Поделиться через


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

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

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

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