Функция MsiReinstallFeatureW (msi.h)
Функция MsiReinstallFeature переустанавливает компоненты.
Синтаксис
UINT MsiReinstallFeatureW(
[in] LPCWSTR szProduct,
[in] LPCWSTR szFeature,
[in] DWORD dwReinstallMode
);
Параметры
[in] szProduct
Указывает код продукта, содержащего компонент для переустановки.
[in] szFeature
Указывает компонент, который необходимо переустановить. Родительская или дочерняя функция указанного компонента не переустановлена. Чтобы переустановить родительский или дочерний компонент, необходимо вызвать функцию MsiReinstallFeature для каждого отдельного компонента или использовать функцию MsiReinstallProduct .
[in] dwReinstallMode
Указывает, что нужно установить. Этот параметр может быть одним или несколькими из следующих значений.
| Значение | Значение |
|---|---|
|
Переустановите, только если файл отсутствует. |
|
Переустановите, если файл отсутствует или является более старой версией. |
|
Переустановите, если файл отсутствует или является равной или более старой версии. |
|
Переустановите, если файл отсутствует или имеет другую версию. |
|
Проверьте значения контрольной суммы и переустановите файл, если они отсутствуют или повреждены. Этот флаг восстанавливает только файлы с msidbFileAttributesChecksum в столбце Атрибуты таблицы Файл. |
|
Принудительная переустановка всех файлов независимо от контрольной суммы или версии. |
|
Перезапись всех необходимых записей реестра из таблицы реестра , которые переходят в HKEY_CURRENT_USER или HKEY_USERS куст реестра. |
|
Перезапись всех необходимых записей реестра из таблицы реестра , которые переходят в HKEY_LOCAL_MACHINE или HKEY_CLASSES_ROOT куст реестра. Переписывание всех сведений из таблицы классов, таблицы глаголов, таблицы PublishComponent, таблицы ProgID, таблицы MIME, таблицы значков, таблицы расширений и таблицы AppID независимо от назначения компьютера или пользователя. Переустановите все соответствующие компоненты.
При переустановке приложения этот параметр запускает действия RegisterTypeLibraries и InstallODBC . |
|
Переустановите все ярлыки и повторно кэшируйте все значки, перезаписав все существующие ярлыки и значки. |
|
Используйте для запуска из исходного пакета и повторного кэширования локального пакета. Не используйте для первой установки приложения или компонента. |
Возвращаемое значение
| Код возврата | Описание |
|---|---|
|
Сбой установки. |
|
В функцию передан недопустимый параметр. |
|
Не удалось получить доступ к службе установки. |
|
Установка была приостановлена и не завершена. |
|
Пользователь отменил установку. |
|
Функция успешно завершена. |
|
Идентификатор компонента не идентифицирует известный компонент. |
|
Код продукта не идентифицирует известный продукт. |
Дополнительные сведения см. в разделе Отображаемые сообщения об ошибках.
Комментарии
Примечание
Заголовок 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 |
См. также раздел
Функции установки и конфигурации