通过

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

注册表配置单元。 重写 类表、谓词表、PublishComponent 表、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
 功能 ID 不标识已知功能。
ERROR_UNKNOWN_PRODUCT
 该代码示例不标识已知产品。
 

有关详细信息，请参阅 显示错误消息。

言论

注意

msi.h 标头将 MsiReinstallFeature 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer。 有关 Windows Installer 版本所需的最低 Windows Service Pack 的信息，请参阅 Windows Installer Run-Time 要求。
目标平台 窗户
标头 msi.h
库 Msi.lib
DLL Msi.dll

另请参阅

安装和配置函数

Multiple-Package 安装

REINSTALLMODE 属性