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

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

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

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