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

Статья
03/05/2024

Функция MsiRemovePatches удаляет один или несколько исправлений из одного продукта. Чтобы удалить исправление из нескольких продуктов, необходимо вызвать MsiRemovePatches для каждого продукта.

Синтаксис

UINT MsiRemovePatchesA(
  [in]           LPCSTR      szPatchList,
  [in]           LPCSTR      szProductCode,
  [in]           INSTALLTYPE eUninstallType,
  [in, optional] LPCSTR      szPropertyList
);

Параметры

[in] szPatchList

Строка, завершающаяся значением NULL, представляющая список исправлений для удаления. Каждое исправление можно указать с помощью GUID исправления или полного пути к пакету исправлений. Исправления в списке разделяются точкой с запятой.

[in] szProductCode

Строка, завершающаяся null, которая представляет собой Код Продукта (GUID) продукта, из которого удаляются исправления. Этот параметр не может иметь значение NULL.

[in] eUninstallType

Значение, указывающее тип удаления исправления для выполнения. Этот параметр должен быть INSTALLTYPE_SINGLE_INSTANCE.

Значение	Значение
INSTALLTYPE_SINGLE_INSTANCE	Исправление удаляется только для продукта, указанного в szProduct.

[in, optional] szPropertyList

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Добавлен недопустимый параметр.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Не удалось открыть пакет исправлений.
ERROR_SUCCESS	Исправление успешно удалено.
ERROR_UNKNOWN_PRODUCT	Продукт, указанный szProductList , не устанавливается ни для компьютера, ни для каждого пользователя для вызывающего объекта MsiRemovePatches.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Не удалось открыть пакет исправлений.
ERROR_PATCH_PACKAGE_INVALID	Пакет исправлений недопустим.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Пакет исправлений не может быть обработан этой версией службы установщика Windows.
ERROR_PATCH_REMOVAL_UNSUPPORTED	Пакет исправлений не является съемным.
ERROR_UNKNOWN_PATCH	Исправление не было применено к этому продукту.
ERROR_PATCH_REMOVAL_DISALLOWED	Удаление исправлений запрещено политикой.

Заголовок msi.h определяет MsiRemovePatches в качестве псевдонима, который автоматически выбирает версию 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