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

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

  • Статья

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

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

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