MsiConfigureProductExA 函式 (msi.h)

發行項
03/15/2023

MsiConfigureProductEx函式會安裝或卸載產品。您也可以指定產品命令列。

語法

UINT MsiConfigureProductExA(
  [in] LPCSTR       szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState,
  [in] LPCSTR       szCommandLine
);

參數

[in] szProduct

指定要設定之產品的產品代碼。

[in] iInstallLevel

指定將產品安裝至其預設狀態時，應該安裝多少產品。如果eInstallState參數設定為INSTALLSTATE_DEFAULT以外的任何值，則會忽略iInstallLevel參數，而且會安裝所有功能。

此參數可以是下列其中一個值。

值	意義
INSTALLLEVEL_DEFAULT	系統會安裝撰寫的預設功能。
INSTALLLEVEL_MINIMUM	只會安裝必要的功能。您可以在 INSTALLLEVEL_MINIMUM 與 INSTALLLEVEL_MAXIMUM 之間指定值，以安裝可用功能的子集。
INSTALLLEVEL_MAXIMUM	已安裝所有功能。您可以在 INSTALLLEVEL_MINIMUM 與 INSTALLLEVEL_MAXIMUM 之間指定值，以安裝可用功能的子集。

[in] eInstallState

指定產品的安裝狀態。此參數可以是下列其中一個值。

值	意義
INSTALLSTATE_LOCAL	產品會隨本機安裝的所有功能一起安裝。
INSTALLSTATE_ABSENT	產品已卸載。
INSTALLSTATE_SOURCE	產品會隨安裝以從來源執行的所有功能一起安裝。
INSTALLSTATE_DEFAULT	產品會隨安裝到功能資料表中指定的預設狀態的所有功能一起安裝。
INSTALLSTATE_ADVERTISED	產品已公告。

[in] szCommandLine

指定命令列屬性設定。這應該是 Property=Setting Property=Setting格式的清單。如需詳細資訊，請參閱關於屬性。

傳回值

值	意義
ERROR_INVALID_PARAMETER	不正確參數會傳遞至函式。
ERROR_SUCCESS	此函數已成功。
與動作相關的錯誤	如需詳細資訊，請參閱錯誤碼。
初始化錯誤	發生與初始化相關的錯誤。

備註

以 szCommandLine 身分傳入的命令列可以包含任何功能安裝選項屬性。在此情況下，傳遞 的 eInstallState 必須 INSTALLSTATE_DEFAULT。

如果eInstallState參數設定為INSTALLSTATE_DEFAULT以外的任何其他值，則會忽略iInstallLevel參數，而且會安裝產品的所有功能。當 eInstallState 參數未設定為 INSTALLSTATE_DEFAULT 使用 MsiConfigureFeature時，控制個別功能的安裝。

MsiConfigureProductEx函式會使用目前的設定來顯示使用者介面。您可以使用MsiSetInternalUI、MsiSetExternalUI 或 MsiSetExternalUIRecord來變更使用者介面設定。

注意

msi.h 標頭會根據 UNICODE 預處理器常數的定義，將 MsiConfigureProductEx 定義為別名，自動選取此函式的 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 Installer 版本所需的最低 Windows Service Pack 相關資訊，請參閱 Windows Installer Run-Time 需求。
目標平台	Windows
標頭	msi.h
程式庫	Msi.lib
Dll	Msi.dll