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

Статья
11/20/2024

Функция 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, указывающая параметры свойств командной строки, используемые во время исправления продуктов. Если нет параметров свойства командной строки, передайте указатель 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".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll