共用方式為

MsiQueryComponentStateA 函式 （msi.h）

  • 發行項

MsiQueryComponentState 函式會傳回元件的已安裝狀態。 此函式可以查詢在目前使用者以外的用戶帳戶下所安裝產品實例的元件，但前提是產品未在目前使用者以外的使用者帳戶的個別使用者非受控內容下公告。 呼叫程式必須具有系統管理許可權，才能取得目前使用者以外的使用者所安裝產品的資訊。

語法

UINT MsiQueryComponentStateA(
  [in]  LPCSTR            szProductCode,
  [in]  LPCSTR            szUserSid,
  [in]  MSIINSTALLCONTEXT dwContext,
  [in]  LPCSTR            szComponentCode,
  [out] INSTALLSTATE      *pdwState
);

參數

[in] szProductCode

指定包含元件之產品的 ProductCode GUID。

[in] szUserSid

指定要查詢產品實例所在的帳戶安全性標識碼 （SID）。 如果未MSIINSTALLCONTEXT_MACHINE dwContext，null 會指定目前的使用者。

SID 的類型 意義
NULL
 NULL 表示目前登入的使用者。
使用者 SID
 指定系統中特定用戶的列舉。 使用者 SID 的範例是 “S-1-3-64-2415071341-1358098788-3127455600-2561”。
 
附註 特殊 SID 字串 “S-1-5-18” （system） 無法用來列舉依機器安裝的產品。 如果 dwContext 為 MSIINSTALLCONTEXT_MACHINE，szUserSid 必須是 null。
 

[in] dwContext

要查詢之產品實例的安裝內容。

名字 意義
MSIINSTALLCONTEXT_USERMANAGED
 擷取產品的每個使用者受控實例的元件狀態。
MSIINSTALLCONTEXT_USERUNMANAGED
 擷取產品的每個使用者非受控實例的元件狀態。
MSIINSTALLCONTEXT_MACHINE
 擷取產品之每部機器實例的元件狀態。

[in] szComponentCode

指定要查詢的元件。 元件 數據表的 ComponentID 資料行中找到的元件程式代碼 GUID。

[out] pdwState

指定產品實例之元件的安裝狀態。 此參數可以傳回下列其中一個或 Null 值。

價值 意義
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 錯誤碼的失敗。
ERROR_MORE_DATA
 緩衝區太小，無法取得使用者 SID。
 

如需詳細資訊，請參閱 顯示的錯誤訊息。

言論

注意

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

另請參閱

元件

顯示錯誤訊息

安裝程式選取函式

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

ProductCode