MsiConfigureProductExW 函式（msi.h）

發行項
11/20/2024

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

語法

UINT MsiConfigureProductExW(
  [in] LPCWSTR      szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState,
  [in] LPCWSTR      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	產品會隨安裝到 Feature Table中所指定之默認狀態的所有功能一起安裝。
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 需求。
目標平臺	窗戶
標頭	msi.h
連結庫	Msi.lib
DLL	Msi.dll