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