Функция MsiApplyMultiplePatchesA (msi.h)

Статья
08/24/2023

Функция MsiApplyMultiplePatches применяет одно или несколько исправлений к продуктам, которые могут получать исправления. Функция MsiApplyMultiplePatches задает свойство PATCH со списком исправлений, разделенных точкой с запятой, и вызывает исправление целевых продуктов. Другие свойства можно задать с помощью списка свойств.

Синтаксис

UINT MsiApplyMultiplePatchesA(
  [in]           LPCSTR szPatchPackages,
  [in, optional] LPCSTR szProductCode,
  [in, optional] LPCSTR szPropertiesList
);

Параметры

[in] szPatchPackages

Разделенный точкой с запятой список путей для исправления файлов в виде одной строки. Например: ""c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp" "

[in, optional] szProductCode

Этот параметр является ИДЕНТИФИКАТОРом GUID ProductCode продукта, который требуется исправить. Пользователь или приложение, вызывающие MsiApplyMultiplePatches, должны иметь права на применение исправлений. Если этот параметр имеет значение NULL, исправления применяются ко всем соответствующим продуктам. Если этот параметр не равен NULL, исправления применяются только к указанному продукту.

[in, optional] szPropertiesList

Строка, завершающаяся значением NULL, указывающая параметры свойств командной строки, используемые во время установки исправлений продуктов. Если параметры свойств командной строки отсутствуют, передайте указатель NULL . Пустая строка является недопустимым параметром. Эти свойства являются общими для всех целевых продуктов. Дополнительные сведения см. в разделе
Сведения о свойствах и настройке значений открытых свойств в командной строке.

Примечание Список свойств не должен содержать свойство PATCH . Если свойство PATCH задано в командной строке, значение игнорируется и перезаписывается применяемыми исправлениями.

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

Функция MsiApplyMultiplePatches возвращает следующие значения.

Значение	Значение
ERROR_INVALID_PARAMETER	Некоторые переданные аргументы являются неверными или противоречивыми.
ERROR_SUCCESS	Функция завершена, и все продукты успешно исправлены. ERROR_SUCCESS возвращается только в том случае, если все продукты, подходящие для исправлений, успешно исправлены. Если ни одно из новых исправлений не применяется, MsiApplyMultiplePatches возвращает ERROR_SUCCESS , а состояние продукта остается неизменным.
ERROR_SUCCESS_REBOOT_INITIATED	Перезапуск, инициированный последней транзакцией, завершил этот вызов MsiApplyMultiplePatches. Возможно, все целевые продукты не были исправлены.
ERROR_SUCCESS_REBOOT_REQUIRED	Перезапуск, необходимый для последней транзакции, завершил этот вызов MsiApplyMultiplePatches. Возможно, все целевые продукты не были исправлены.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Не удалось открыть один из пакетов исправлений.
ERROR_PATCH_PACKAGE_INVALID	Один из предоставляемых пакетов исправлений не является допустимым.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Один из пакетов исправлений не поддерживается.
Любая ошибка в Winerror.h	Подразумевает возможное частичное завершение или ошибку одной или нескольких транзакций.

Заголовок msi.h определяет MsiApplyMultiplePatches в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Установщик 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, см. в статье Требования к установщику Windows Run-Time.
Целевая платформа	Windows
Header	msi.h
Библиотека	Msi.lib
DLL	Msi.dll