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」 (系統) 無法用來列舉依每部電腦安裝的產品。 如果 dwContext是MSIINSTALLCONTEXT_MACHINE，szUserSid 必須是 null。
 

[in] dwContext

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

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

[in] szComponentCode

指定要查詢的元件。 在 Component 資料表的 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 標頭會將 MsiQueryComponentState 定義為別名，根據 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 Installer 版本所需的最低 Windows Service Pack 相關信息，請參閱 Windows Installer Run-Time 需求。
目標平台 Windows
標頭 msi.h
程式庫 Msi.lib
Dll Msi.dll

另請參閱

元件

顯示的錯誤訊息

安裝程式選取函式

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

ProductCode