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