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

  • Статья

Функция MsiReinstallProduct переустанавливает продукты.

Синтаксис

UINT MsiReinstallProductA(
  [in] LPCSTR szProduct,
  [in] DWORD  szReinstallMode
);

Параметры

[in] szProduct

Указывает код продукта для переустановки.

[in] szReinstallMode

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

Значение Значение
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

куст реестра. Переписывание всех сведений из таблицы классов, таблицы команд, таблицы PublishComponent, таблицы ProgID, таблицы MIMET, таблицы значков, таблицы расширений и таблицы 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_PRODUCT
 Код продукта не идентифицирует известный продукт.
 

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

Комментарии

Примечание

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