Product.ComponentState 方法

ComponentState屬性是此產品實例之元件的安裝狀態。

這個屬性會使用 物件的 ProductCode、UserSid 和 CoNtext 呼叫 MsiQueryComponentState。 元件識別碼 GUID 會以參數的形式提供。

語法

Product.ComponentState(
  ID
)

參數

識別碼

元件資料表的 ComponentID 資料行中找到的元件程式碼 GUID。

傳回值

這個方法不會傳回值。

備註

如果呼叫成功,屬性就會包含值做為 DWORD

狀態 意義
INSTALLSTATE_LOCAL 元件會安裝在本機。
INSTALLSTATE_SOURCE 元件會安裝為從來源執行。

 

如果呼叫失敗,屬性會包含 來自 MsiQueryComponentState的錯誤碼。

錯誤 意義
ERROR_ACCESS_DENIED 呼叫進程必須具有系統管理許可權,才能取得目前使用者以外的使用者資訊。
ERROR_BAD_CONFIGURATION 組態資料已損毀。
ERROR_INVALID_PARAMETER 不正確參數已傳遞至 函式。
ERROR_SUCCESS 語言函式已順利完成。
ERROR_UNKNOWN_COMPONENT 元件識別碼不會識別已知的元件。
ERROR_UNKNOWN_PRODUCT 產品代碼不會識別已知的產品。
ERROR_FUNCTION_FAILED 非預期的內部失敗。

 

規格需求

需求
版本
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 2000 上的 Windows Installer 3.0 或更新版本
DLL
Msi.dll
IID
IID_IProduct定義為 000C10A0-0000-0000-C000-000000000046

另請參閱

產品

MsiQueryComponentState

Windows Installer 2.0 和更早版本中不支援