Поделиться через


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

Функция MsiReinstallFeature переустановит функции.

Синтаксис

UINT MsiReinstallFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwReinstallMode
);

Параметры

[in] szProduct

Указывает код продукта для продукта, содержащего функцию, которую необходимо переустановить.

[in] szFeature

Указывает функцию, которая должна быть переустановлена. Родительский компонент или дочерний компонент указанной функции не переустановлен. Чтобы переустановить родительский или дочерний компонент, необходимо вызвать функцию MsiReinstallFeature для каждой отдельной функции или использовать функцию MsiReinstallProduct.

[in] dwReinstallMode

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

Ценность Значение
REINSTALLMODE_FILEMISSING
Переустановите только в том случае, если файл отсутствует.
REINSTALLMODE_FILEOLDERVERSION
Переустановите, если файл отсутствует или является более старой версией.
REINSTALLMODE_FILEEQUALVERSION
Переустановите файл, если файл отсутствует или является равной или более старой версией.
REINSTALLMODE_FILEEXACT
Переустановите, если файл отсутствует или является другой версией.
REINSTALLMODE_FILEVERIFY
Проверьте значения контрольной суммы и переустановите файл, если они отсутствуют или повреждены. Этот флаг восстанавливает только файлы с msidbFileAttributesChecksum в столбце "Атрибуты" таблицы файлов .
REINSTALLMODE_FILEREPLACE
Принудительно переустановите все файлы независимо от контрольной суммы или версии.
REINSTALLMODE_USERDATA
Перезапись всех необходимых записей реестра из таблицы реестра , которая переходит к HKEY_CURRENT_USER

или HKEY_USERS

Hive реестра.
REINSTALLMODE_MACHINEDATA
Переопределите все необходимые записи реестра из таблицы реестра , которая переходит к HKEY_LOCAL_MACHINE

или HKEY_CLASSES_ROOT

Hive реестра. Перезапись всех сведений из таблицы классов , таблицы команд, publishComponent Table, таблицу ProgID, таблицу MIME, таблицу значков, таблицу расширенийи таблицу AppID независимо от назначения компьютера или пользователя. Переустановите все квалифицированные компоненты.

При переустановке приложения этот параметр выполняет действия RegisterTypeLibraries и InstallODBC.

REINSTALLMODE_SHORTCUT
Переустановите все сочетания клавиш и повторно кэшируйте все значки, перезаписав все существующие сочетания клавиш и значки.
REINSTALLMODE_PACKAGE
Используется для запуска из исходного пакета и повторно кэширует локальный пакет. Не используйте для первой установки приложения или компонента.

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

Возвращаемый код Описание
ERROR_INSTALL_FAILURE
Сбой установки.
ERROR_INVALID_PARAMETER
Недопустимый параметр был передан функции.
ERROR_INSTALL_SERVICE_FAILURE
Доступ к службе установки невозможен.
ERROR_INSTALL_SUSPEND
Установка была приостановлена и не завершена.
ERROR_INSTALL_USEREXIT
Пользователь отменил установку.
ERROR_SUCCESS
Функция успешно завершена.
ERROR_UNKNOWN_FEATURE
Идентификатор компонента не определяет известную функцию.
ERROR_UNKNOWN_PRODUCT
Код продукта не определяет известный продукт.
 

Дополнительные сведения см. в разделе Отображаемые сообщения об ошибках.

Замечания

Заметка

Заголовок msi.h определяет MsiReinstallFeature как псевдоним, который автоматически выбирает версию 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 Server 2003 или Windows XP. Сведения о минимальном пакете обновления Windows, требуемом версией установщика Windows, см. в разделе "Требования к установщику Windows Run-Time".
целевая платформа Виндоус
заголовка msi.h
библиотеки Msi.lib
DLL Msi.dll

См. также

функции установки и настройки

Multiple-Package установки

свойству REINSTALLMODE