共用方式為


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 資料表 中的所有資訊。 重新安裝所有 合格的元件

重新安裝應用程式時,此選項會執行 RegisterTypeLibrariesInstallODBC 動作。

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 屬性