Справочник по функции установщика

Чтобы включить установщик Windows в приложении, необходимо использовать функции установщика. Таблицы в этом разделе определяют функции по категориям.

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

Имя	Описание
MsiSetInternalUI	Включает внутренний пользовательский интерфейс установщика.
MsiSetExternalUI	Включает внешний обработчик пользовательского интерфейса, который получает сообщения в строковом формате.
MsiSetExternalUIRecord	Включает внешний обработчик пользовательского интерфейса, который получает сообщения в формате записи.
MsiEnableLog	Задает режим журнала для всех установок в процессе вызова.

 

Обработка функций управления

Имя	Описание
MsiCloseHandle	Закрывает открытый дескриптор установки.
MsiCloseAllHandles	Закрывает все открытые дескрипторы установки. Не используйте для очистки.

 

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

Имя	Описание
MsiAdvertiseProduct	Рекламирует продукт.
MsiAdvertiseProductEx	Рекламирует продукт.
MsiAdvertiseScript	Копирует файл скрипта объявления в указанные расположения.
MsiInstallProduct	Устанавливает или удаляет приложение или набор приложений.
MsiConfigureProduct	Устанавливает или удаляет приложение или набор приложений.
MsiConfigureProductEx	Устанавливает или удаляет приложение или набор приложений. Можно указать командную строку продукта.
MsiReinstallProduct	Переустановка или восстановление установки.
MsiConfigureFeature	Настраивает установленное состояние компонента.
MsiReinstallFeature	Проверяет или восстанавливает функции.
MsiInstallMissingComponent	Устанавливает отсутствующие компоненты.
MsiInstallMissingFile	Устанавливает отсутствующие файлы.
MsiNotifySidChange	Уведомляет и обновляет внутреннюю информацию установщика Windows с изменениями идентификаторов идентификаторов пользователей. Доступно начиная с установщика Windows 3.1.
MsiProcessAdvertiseScript	Обрабатывает файл скрипта объявления в указанных расположениях.
MsiSourceListAddSource	Добавляет или переупорядочение источников исправлений или продуктов в указанном контексте.
MsiSourceListAddSourceEx	Добавляет или переупорядочение источников исправлений или продуктов в указанном контексте. Создает исходный список для исправления, который не существует в указанном контексте. Доступно в установщике Windows 3.0.
MsiSourceListClearSource	Удаляет существующий источник для продукта или исправления в указанном контексте. Доступно в установщике Windows 3.0.
MsiSourceListClearAll	Удаляет все существующие источники определенного типа источника для указанного экземпляра продукта.
MsiSourceListClearAllEx	Удаляет все существующие источники определенного типа источника для указанного экземпляра продукта. Доступно в установщике Windows 3.0.
MsiSourceListForceResolution	Удаляет регистрацию текущего источника продукта или исправления, зарегистрированного в качестве свойства LastUsedSource. Эта функция не влияет на зарегистрированный список источников.
MsiSourceListForceResolutionEx	Удаляет регистрацию текущего источника продукта или исправления, зарегистрированного в качестве свойства LastUsedSource. Эта функция не влияет на зарегистрированный список источников. Доступно в установщике Windows 3.0.
MsiSourceListGetInfo	Извлекает сведения о исходном списке для продукта или исправления в определенном контексте.
MsiSourceListSetInfo	Задает последний используемый источник для продукта или исправления в указанном контексте. Доступно в установщике Windows 3.0.
MsiSourceListEnumMediaDisks	Перечисляет список дисков, зарегистрированных для источника мультимедиа для исправления или продукта. Доступно в установщике Windows 3.0.
MsiSourceListAddMediaDisk	Добавляет или обновляет диск источника носителя зарегистрированного продукта или исправления. Доступно в установщике Windows 3.0.
MsiSourceListClearMediaDisk	Удаляет существующий зарегистрированный диск в источнике мультимедиа для продукта или исправления в определенном контексте. Доступно в установщике Windows 3.0.
MsiSourceListEnumSources	Перечисляет источники в исходном списке указанного исправления или продукта. Доступно в установщике Windows 3.0.

 

Функции Component-Specific

Имя	Описание
MsiProvideAssembly	Устанавливает и возвращает полный путь компонента для сборки.
MsiProvideComponent	Устанавливает и возвращает полный путь к компоненту.
MsiProvideQualifiedComponent	Устанавливает и возвращает полный путь к компоненту квалифицированного компонента.
MsiProvideQualifiedComponentEx	Устанавливает и возвращает полный путь к компоненту квалифицированного компонента, опубликованного продуктом.
MsiGetComponentPath	Возвращает полный путь или раздел реестра в установленный компонент.
MsiGetComponentPathEx	Возвращает полный путь или раздел реестра в установленный компонент в учетных записях пользователей и контексте установки. Установщик Windows 4.5 и более ранние: Не поддерживается.
MsiLocateComponent	Возвращает полный путь к установленному компоненту без кода продукта.
MsiQueryComponentState	Возвращает установленное состояние для компонента. Может запрашивать компоненты экземпляра продукта, установленного в учетных записях пользователей, отличных от текущего пользователя. Доступно в установщике Windows 3.0 или более поздней версии.

 

Функции Application-Only

Имя	Описание
MsiCollectUserInfo	Хранит сведения о пользователе из мастера установки.
MsiUseFeature	Увеличивает количество использования для компонента и указывает состояние установки.
MsiUseFeatureEx	Увеличивает количество использования для компонента и указывает состояние установки.
MsiGetProductCode	Возвращает код продукта с помощью кода компонента.

 

Функции состояния системы

Имя	Описание
MsiEnumProducts	Перечисляет объявленные продукты.
MsiEnumProductsEx	Перечисляет все экземпляры объявленных или установленных продуктов в указанном контексте. Доступно в установщике Windows 3.0 или более поздней версии.
MsiEnumRelatedProducts	Перечисляет установленные в настоящее время продукты с указанным кодом обновления.
MsiEnumFeatures	Перечисляет опубликованные функции.
MsiEnumComponents	Перечисляет установленные компоненты.
MsiEnumComponentsEx	Перечисляет установленные компоненты в учетных записях пользователей и контексте установки. Установщик Windows 4.5 и более ранние: Не поддерживается.
MsiEnumClients	Перечисляет клиенты установленного компонента.
MsiEnumClientsEx	Перечисляет клиенты установленного компонента в учетных записях пользователей и контексте установки. Установщик Windows 4.5 и более ранние: Не поддерживается.
MsiEnumComponentQualifiers	Перечисляет объявленные квалификаторы для компонента.
MsiQueryFeatureState	Возвращает установленное состояние компонента.
MsiQueryFeatureStateEx	Возвращает установленное состояние для компонента продукта. Может запрашивать функции экземпляра продукта, установленного в учетных записях пользователей, отличных от текущего пользователя. Доступно в установщике Windows 3.0 или более поздней версии.
MsiQueryProductState	Возвращает установленное состояние для приложения или набора приложений.
MsiGetFeatureUsage	Возвращает метрики использования для функции.
MsiGetProductInfo	Возвращает сведения о продукте для опубликованных и установленных продуктов.
MsiGetProductInfoEx	Возвращает сведения о продукте для объявленных и установленных продуктов. Может получить сведения о экземпляре продукта, установленного под учетной записью пользователя, отличной от текущего пользователя. Доступно в установщике Windows 3.0 или более поздней версии.
MsiGetUserInfo	Возвращает зарегистрированные сведения о пользователе для установленного продукта.

 

Функции запроса продукта

Имя	Описание
MsiOpenProduct	Открывает продукт, используемый с функциями, которые обращаются к базе данных.
MsiOpenPackage	Открывает пакет для использования с функциями, которые обращаются к базе данных.
MsiOpenPackageEx	Открывает пакет для использования с функциями, которые обращаются к базе данных.
MsiIsProductElevated	Проверяет, установлен ли продукт с повышенными привилегиями.
MsiGetProductInfoFromScript	Возвращает сведения о продукте для файла скрипта установщика.
MsiGetProductProperty	Извлекает свойства в базе данных продукта.
MsiGetShortcutTarget	Проверяет ярлык и возвращает его продукт, имя компонента и компонент, если он доступен.
MsiGetFeatureInfo	Возвращает описательные сведения для функции.
MsiVerifyPackage	Проверяет, является ли указанный файл пакетом установки.

 

Функции исправления

Имя	Описание
MsiApplyPatch	Вызывает установку и применяет пакет исправлений.
MsiEnumPatches	Возвращает GUID для каждого исправления, применяемого к продукту, и список преобразований из каждого исправления, применяемого к продукту.
MsiGetPatchInfo	Возвращает сведения о исправлении.
MsiRemovePatches	Удаляет исправление из продукта. Доступно в установщике Windows 3.0.
MsiDeterminePatchSequence	Определяет лучшую последовательность приложений для набора исправлений и продуктов. Доступно в установщике Windows 3.0.
MsiApplyMultiplePatches	Применяет один или несколько исправлений к продуктам. Доступно в установщике Windows 3.0.
MsiEnumPatchesEx	Перечисляет все исправления, примененные к продукту в определенном контексте или во всех контекстах. Доступно в установщике Windows 3.0.
MsiGetPatchFileList	При указании списка MSP-файлов эта функция извлекает список файлов, которые могут быть обновлены исправлениями для тарге. Доступно в установщике Windows 4.0.
MsiGetPatchInfoEx	Запрашивает сведения о приложении указанного исправления к указанному продукту. Доступно в установщике Windows 3.0.
MsiExtractPatchXMLData	Извлекает сведения из исправления. Доступно в установщике Windows 3.0.
MsiDetermineApplicablePatches	Определяет лучший набор исправлений, необходимых для обновления продукта или набора продуктов. Доступно в установщике Windows 3.0.

 

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

Имя	Описание
MsiGetFileHash	Возвращает путь к файлу и возвращает 128-разрядный хэш этого файла.
MsiGetFileSignatureInformation	Получает путь к файлу с цифровой подписью и возвращает сертификат подписи и хэш файла.
MsiGetFileVersion	Возвращает строку версии и строку языка.

 

Функции управления транзакциями

Имя	Описание
MsiBeginTransaction	Запускает обработку транзакций установки нескольких пакетов и возвращает идентификатор транзакции. Эта функция доступна начиная с установщика Windows 4.5.
MsiJoinTransaction	Запросы, что установщик Windows делает текущий процесс владельцем транзакции, устанавливающей многопакетную установку. Эта функция доступна начиная с установщика Windows 4.5.
MsiEndTransaction	Фиксирует или откатывает все установки, принадлежащие транзакции. Эта функция доступна начиная с установщика Windows 4.5.

 

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

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

Структуры установщика

Кроме того, некоторые сведения в базе данных установки обрабатываются с помощью структур, описанных в разделе Структуры установщика.