共用方式為

MsiConfigureProductA 函式 （msi.h）

  • 發行項

MsiConfigureProduct 函式會安裝或卸載產品。

語法

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

參數

[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
 產品已公告。

傳回值

價值 意義
ERROR_INVALID_PARAMETER
 無效的參數會傳遞至函式。
ERROR_SUCCESS
 函式成功。
與動作相關的錯誤
 如需詳細資訊，請參閱 錯誤碼。
初始化錯誤
 與初始化相關的錯誤。

言論

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

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

注意

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