Функция MsiReinstallFeatureA (msi.h)
Функция MsiReinstallFeature переустанавливает компоненты.
Синтаксис
UINT MsiReinstallFeatureA(
[in] LPCSTR szProduct,
[in] LPCSTR szFeature,
[in] DWORD dwReinstallMode
);
Параметры
[in] szProduct
Указывает код продукта, который содержит функцию для переустановки.
[in] szFeature
Указывает функцию, которая должна быть переустановлена. Родительская или дочерняя функция указанного компонента не переустановлена. Чтобы переустановить родительскую или дочернюю функцию, необходимо вызвать функцию MsiReinstallFeature для каждого отдельного компонента или использовать функцию MsiReinstallProduct .
[in] dwReinstallMode
Указывает, что нужно установить. Этот параметр может иметь одно или несколько из следующих значений.
| Значение | Значение |
|---|---|
|
Переустановите, только если файл отсутствует. |
|
Переустановите его, если файл отсутствует или является более старой версией. |
|
Переустановите его, если файл отсутствует или имеет равную или более раннюю версию. |
|
Переустановите файл, если файл отсутствует или имеет другую версию. |
|
Проверьте значения контрольной суммы и переустановите файл, если они отсутствуют или повреждены. Этот флаг восстанавливает только файлы с msidbFileAttributesChecksum в столбце Атрибуты таблицы Файл. |
|
Принудительная переустановка всех файлов независимо от контрольной суммы или версии. |
|
Перезапишите все необходимые записи реестра из таблицы реестра , которые переходят в HKEY_CURRENT_USER или HKEY_USERS куст реестра. |
|
Перезапишите все необходимые записи реестра из таблицы реестра , которые переходят в HKEY_LOCAL_MACHINE или HKEY_CLASSES_ROOT куст реестра. Переписывание всех сведений из таблицы классов, таблицы verb, publishComponent Table, таблицы 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 |