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


Объект установщика

Сначала необходимо создать объект установщика , чтобы загрузить поддержку автоматизации, необходимую com для доступа к функциям установщика. Этот объект предоставляет оболочки для создания объектов верхнего уровня и доступа к их методам.

Объект установщика можно создать из ProgId "WindowsInstaller.Installer".

Элементы

Объект Установщика имеет следующие типы элементов:

Методы

Объект Installer содержит следующие методы.

Метод Описание
AddSource Добавляет источник в список допустимых сетевых источников в списке источников.
Рекламный продукт Объявляет пакет установки.
Рекламный скрипт Объявляет пакет установки.
ApplyMultiplePatches Применяет одно или несколько исправлений к продуктам, имеющим право на получение исправления. Задает для свойства PATCH путь к предоставленным пакетам исправлений.
ApplyPatch Вызывает установку и задает свойству PATCH путь к пакету исправлений для каждого продукта, указанного в пакете исправлений как подходящего для получения исправления.
ClearSourceList Удаляет все сетевые источники из исходного списка.
CollectUserInfo Вызывает последовательность мастера пользовательского интерфейса, которая собирает и сохраняет сведения о пользователе и код продукта.
ConfigureFeature Настраивает состояние установленного компонента продукта.
ConfigureProduct Устанавливает или удаляет продукт.
CreateAdvertiseScript Создает скрипт объявления.
CreateRecord Возвращает новый объект Record с запрошенным числом полей.
EnableLog Включает ведение журнала выбранного типа сообщения для всех последующих сеансов установки в текущем пространстве процессов.
ExtractPatchXMLData Извлекает сведения из исправления в виде XML-строки.
FileHash Получает путь к файлу и возвращает 128-разрядный хэш этого файла.
FileSignatureInfo Принимает путь к файлу и возвращает SAFEARRAY из байтов, представляющий хэш или закодированный сертификат.
FileSize Возвращает размер указанного файла.
FileVersion Возвращает строку версии или языковую строку указанного пути.
ForceSourceListResolution При следующей необходимости установщик выполняет поиск допустимого источника продукта в списке источников.
InstallProduct Открывает пакет установщика и инициализирует сеанс установки.
LastErrorRecord Возвращает объект Record , содержащий параметры ошибки для последней ошибки из функции, создающей запись об ошибке.
OpenDatabase Открывает существующую базу данных или создает новую.
OpenPackage Открывает пакет установщика для использования с функциями, которые обращаются к базе данных продукта и ядру установки.
OpenProduct Открывает пакет установщика для установленного продукта с помощью кода продукта.
ProvideAssembly Возвращает установленный путь сборки.
ProvideComponent Возвращает полный путь к компоненту и выполняет необходимую установку.
ProvideQualifiedComponent Возвращает полный путь к компоненту и выполняет необходимую установку.
RegistryValue Считывает сведения об указанном разделе реестра со значением.
ReinstallFeature Переустановка компонентов или устранение проблем с установленными компонентами.
ReinstallProduct Переустановка продукта или устранение проблем с установкой в установленном продукте.
RemovePatches Удаляет одно или несколько исправлений для продуктов, имеющих право на получение исправления.
UseFeature Увеличивает количество использования для конкретного компонента и возвращает состояние установки для этого компонента.

 

Свойства

Объект Installer имеет следующие свойства.

Свойство Тип доступа Описание
ClientsEx
Возвращает объект RecordList , который перечисляет продукты, использующие указанный установленный компонент.
Установщик Windows 4.5 и более ранние версии: Не поддерживается.
ComponentClients
Возвращает объект StringList , перечисляющий набор клиентов указанного компонента.
ComponentPath
Возвращает полный путь к установленному компоненту.
ComponentPathEx
Возвращает объект RecordList , который предоставляет полный путь к указанному установленному компоненту.
Установщик Windows 4.5 и более ранние версии: Не поддерживается.
ComponentQualifiers
Возвращает объект StringList , перечисляющий набор зарегистрированных квалификаторов для указанного компонента.
Компоненты
Возвращает объект StringList , перечисляющий набор установленных компонентов для всех продуктов.
ComponentsEx
Возвращает объект RecordList со списком установленных компонентов.
Установщик Windows 4.5 и более ранние версии: Не поддерживается.
Среды
Чтение/запись
Строковое значение для переменной среды текущего процесса.
FeatureParent
Указывает родительский компонент компонента.
Функции
Возвращает объект StringList , перечисляющий набор опубликованных признаков для указанного продукта.
FeatureState
Возвращает состояние установленного компонента.
FeatureUsageCount
Возвращает количество использованных компонентов.
FeatureUsageDate
Возвращает дату последнего использования указанного компонента.
FileAttributes
Возвращает число, представляющее объединенные атрибуты файла для указанного пути к файлу или папке.
Исправления
Возвращает объект StringList , содержащий все исправления, примененные к продукту.
PatchesEx
Перечисляет коллекцию объектов Patch .
PatchFiles
Возвращает объект StringList , содержащий список файлов, которые можно обновить с помощью предоставленного списка исправлений.
PatchInfo
Возвращает сведения об исправлении.
PatchTransforms
Возвращает разделенный точкой с запятой список преобразований, которые находятся в указанном пакете исправлений и применяются к указанному продукту.
ProductElevated
Возвращает значение True, если продукт является управляемым, или False, если продукт не управляется.
ProductInfo
Возвращает значение указанного атрибута для установленного или опубликованного продукта.
ProductInfoFromScript
Возвращает значение указанного атрибута, хранящегося в скрипте объявления.
Продукты
Возвращает объект StringList , перечисляющий набор всех продуктов, установленных или объявленных для текущего пользователя и компьютера.
ProductsEx
Перечисляет коллекцию объектов Product .
ProductState
Возвращает сведения о состоянии установки для продукта.
КвалификаторDescription
Возвращает текстовую строку, описывающую квалифицированный компонент.
Связанные продукты
Возвращает объект StringList , перечисляющий набор всех продуктов, установленных или объявленных для текущего пользователя и компьютера, с указанным свойством UpgradeCode в таблице свойств.
ЯрлыкЦель
Проверяет ярлык и возвращает его продукт, имя компонента и компонент, если они доступны.
SummaryInformation
Возвращает объект SummaryInfo , который можно использовать для проверки, обновления и добавления свойств в поток сводной информации пакета или преобразования.
UILevel
Чтение/запись
Указывает тип пользовательского интерфейса, который будет использоваться при открытии и обработке последующих пакетов в текущем пространстве процесса.
Версия
Возвращает строковое представление текущей версии установщика Windows.

 

Требования

Требование Значение
Версия
Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или Установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP
DLL
Msi.dll
IID
IID_IInstaller определяется как 000C1090-0000-0000-C000-0000000000046

См. также раздел

Использование интерфейса автоматизации

Примеры сценариев установщика Windows