Функция MsiApplyMultiplePatchesA (msi.h)
Функция 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 . Пустая строка является недопустимым параметром. Эти свойства являются общими для всех целевых продуктов. Дополнительные сведения см. в разделе
Сведения о свойствах и настройке значений открытых свойств в командной строке.
Возвращаемое значение
Функция MsiApplyMultiplePatches возвращает следующие значения.
Значение | Значение |
---|---|
|
Некоторые переданные аргументы являются неверными или противоречивыми. |
|
Функция завершена, и все продукты успешно исправлены. ERROR_SUCCESS возвращается только в том случае, если все продукты, подходящие для исправлений, успешно исправлены. Если ни одно из новых исправлений не применяется, MsiApplyMultiplePatches возвращает ERROR_SUCCESS , а состояние продукта остается неизменным. |
|
Перезапуск, инициированный последней транзакцией, завершил этот вызов MsiApplyMultiplePatches. Возможно, все целевые продукты не были исправлены. |
|
Перезапуск, необходимый для последней транзакции, завершил этот вызов MsiApplyMultiplePatches. Возможно, все целевые продукты не были исправлены. |
|
Не удалось открыть один из пакетов исправлений. |
|
Один из предоставляемых пакетов исправлений не является допустимым. |
|
Один из пакетов исправлений не поддерживается. |
|
Подразумевает возможное частичное завершение или ошибку одной или нескольких транзакций. |
Комментарии
Примечание
Заголовок 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 |
См. также раздел
Установка с несколькими пакетами
Не поддерживается в установщике Windows 2.0 и более ранних версий