Метод Installer.ApplyPatch

Статья
06/12/2023

Для каждого продукта, указанного в пакете исправлений как подходящий для получения исправления, метод ApplyPatch объекта Installer вызывает установку и задает свойству PATCH путь к пакету исправлений.

Синтаксис

Installer.ApplyPatch(
  PatchPackage,
  InstallPackage,
  InstallType,
  CommandLine
)

Параметры

PatchPackage

Указывает путь к пакету исправлений.

InstallPackage

Если для параметра InstallType задано значение msiInstallTypeNetworkImage, InstallPackage указывает путь к продукту, который должен быть исправлен. Если параметр InstallType имеет значение msiInstallTypeDefault, а InstallPackage — 0, установщик применяет исправление к каждому подходящему продукту, указанному в пакете исправлений.

Если installType имеет значение msiInstallTypeSingleInstance, установщик применяет исправление к продукту, указанному в InstallPackage. В этом случае другие подходящие продукты, перечисленные в пакете исправлений, игнорируются, а параметр InstallPackage содержит строку, завершающуюся null, представляющую код продукта экземпляра для исправления. Для установки этого типа требуется версия установщика Windows, поставляемая с Windows Server 2003 или более поздней версии либо установщикОм Windows XP с пакетом обновления 1 (SP1) или более поздней версии.

InstallType

Этот параметр указывает тип установки для исправления. Параметр InstallType игнорируется, если параметр InstallPackage опущен.

Значение	Значение
msiInstallTypeNetworkImage	Указывает административную установку. В этом случае для InstallPackage необходимо задать путь к пакету. Значение 1 для msiInstallTypeNetworkImage указывает административную установку.
msiInstallTypeDefault	Поиск продуктов для исправления в системе. В этом случае InstallPackage должен быть пустой строкой.
msiInstallSingleInstance	Исправление продукта, указанного в InstallPackage. InstallPackage — это код продукта экземпляра для исправления. Для установки этого типа требуется версия установщика Windows, поставляемая с Windows Server 2003 или более поздней версии или установщиком Windows XP с пакетом обновления 1 (SP1) или более поздней версии. Дополнительные сведения см. в статье Установка нескольких экземпляров продуктов и исправлений.

CommandLine

Задает параметры свойств, заданные в командной строке. См. раздел "Примечания".

Возвращаемое значение

Этот метод не возвращает значение.

Поскольку разделитель списка для преобразований, источников и исправлений является точкой с запятой, этот символ не следует использовать для имен файлов или путей.

Свойство REINSTALL является обязательным при применении небольшого обновления или незначительного исправления обновления . Без этого свойства исправление регистрируется в системе, но не может обновлять файлы.

Установщик Windows 2.0: При применении небольшого обновления или дополнительного обновления необходимо задать свойство REINSTALL в командной строке. Для исправлений, которые не используют тип пользовательского действия 51 для автоматического задания свойств REINSTALL и REINSTALLMODE , свойство REINSTALL должно быть явно задано с помощью параметра CommandLine . Задайте свойство REINSTALL , чтобы вывести список функций, затронутых исправлением, или используйте практический параметр по умолчанию "REINSTALL=ALL". Значение по умолчанию свойства REINSTALLMODE — "omus".

Установщик Windows 3.0 и более поздних версий: Начиная с установщика Windows версии 3.0, свойство REINSTALL настраивается установщиком и его не нужно задавать в командной строке.

Требования

Требование	Значение
Версия	Установщик 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 3.0 или более поздней версии в Windows Server 2003 или Windows XP.
DLL	Msi.dll
IID	IID_IInstaller определяется как 000C1090-0000-0000-C000-0000000000046

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

MsiApplyPatch
Сведения о свойствах
Не поддерживается в установщике Windows 2.0 и более ранних версий