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


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

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

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

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