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 資料表之 Attributes 資料行中具有 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 需求。
目標平台 Windows
標頭 msi.h
程式庫 Msi.lib
Dll Msi.dll

另請參閱

安裝和設定函式

多套件安裝

REINSTALLMODE 屬性