Функция 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

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

или HKEY_CLASSES_ROOT

куст реестра. Переписывание всех сведений из таблицы классов, таблицы verb, 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.
Целевая платформа Windows
Header msi.h
Библиотека Msi.lib
DLL Msi.dll

См. также раздел

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

Установка нескольких пакетов

СВОЙСТВО REINSTALLMODE