Справочник по функциям установщика
Чтобы включить установщик 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, указанных в предыдущих таблицах, можно управлять сведениями в базе данных установки с помощью функций доступа к базе данных, описанных в разделе Функции базы данных .
Структуры установщика
Кроме того, некоторые сведения в базе данных установки обрабатываются с помощью структур, описанных в разделе Структуры установщика .
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по