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 表示目前登入的使用者。 |
|
指定系統中特定用戶的列舉。 使用者 SID 的範例是 “S-1-3-64-2415071341-1358098788-3127455600-2561”。 |
注意 特殊的 SID 字串 「S-1-5-18」 (系統) 無法用來列舉依每部電腦安裝的產品。 如果 dwContext是MSIINSTALLCONTEXT_MACHINE，szUserSid 必須是 null。
[in] dwContext
正在查詢之產品實例的安裝內容。
| 名稱 | 意義 |
|---|---|
|
擷取產品個別使用者受控實例的元件狀態。 |
|
擷取產品個別使用者非受控實例的元件狀態。 |
|
擷取產品每部機器實例的元件狀態。 |
[in] szComponentCode
指定要查詢的元件。 在 Component 資料表的 ComponentID 資料行中找到之元件的元件程式代碼 GUID。
[out] pdwState
指定產品實例之元件的安裝狀態。 此參數可以傳回下列其中一個或 Null 值。
| 值 | 意義 |
|---|---|
|
元件會安裝在本機。 |
|
元件會安裝為從來源執行。 |
傳回值
MsiQueryComponentState 函式會傳回下列值。
| 值 | 意義 |
|---|---|
|
呼叫程式必須具有系統管理許可權，才能為目前使用者以外的使用者安裝產品。 |
|
設定數據已損毀。 |
|
無效的參數已傳遞至 函式。 |
|
語言函式已順利完成。 |
|
元件標識碼不會識別已知的元件。 |
|
產品代碼不會識別已知的產品。 |
|
無法訂閱任何 Windows 錯誤碼的失敗。 |
|
緩衝區太小，無法取得使用者 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 |