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

Статья
08/24/2023

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

Синтаксис

UINT MsiApplyMultiplePatchesW(
  [in]           LPCWSTR szPatchPackages,
  [in, optional] LPCWSTR szProductCode,
  [in, optional] LPCWSTR 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 . Пустая строка является недопустимым параметром. Эти свойства являются общими для всех целевых продуктов. Дополнительные сведения см. в разделе
Сведения о свойствах и настройка значений открытых свойств в командной строке.

Примечание Список свойств не должен содержать свойство 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Установщик 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