共用方式為

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
 確認總和檢查碼值，如果檔案遺失或損毀，請重新安裝檔案。 此旗標只會修復在 File 資料表的 [屬性] 資料行中具有 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
 功能標識碼不會識別已知的功能。
ERROR_UNKNOWN_PRODUCT
 產品名稱無法識別已知的產品。
 

如需詳細資訊，請參閱 顯示的錯誤訊息。

言論

注意

msi.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiReinstallFeature 定義為自動選取此函式的 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 屬性