msiQueryFeatureStateExA 函式 (msi.h)

發行項
02/29/2024

MsiQueryFeatureStateEx 函式會傳回產品功能的已安裝狀態。此函式可用來查詢安裝在計算機帳戶下之產品實例的任何功能，或目前用戶帳戶下的任何內容，或目前使用者以外的任何用戶帳戶下的每位使用者管理內容。用戶必須具有系統管理許可權，才能取得目前使用者以外的使用者所安裝產品的資訊。

語法

UINT MsiQueryFeatureStateExA(
  [in]            LPCSTR            szProductCode,
  [in]            LPCSTR            szUserSid,
  [in]            MSIINSTALLCONTEXT dwContext,
  [in]            LPCSTR            szFeature,
  [out, optional] INSTALLSTATE      *pdwState
);

參數

[in] szProductCode

ProductCode 包含感興趣功能的產品的 GUID。

[in] szUserSid

指定帳戶 (SID) 的安全性識別碼，在其中查詢的產品實例存在。如果未MSIINSTALLCONTEXT_MACHINEdwContext，則 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] szFeature

指定正在查詢的功能。在功能數據表的 [功能] 數據行中找到的功能識別碼。

[out, optional] pdwState

指定產品實例之功能的安裝狀態。此參數可以傳回下列其中一個或 null。

值	意義
INSTALLSTATE_ADVERTISED	這項功能已公告。
INSTALLSTATE_LOCAL	此功能會安裝在本機。
INSTALLSTATE_SOURCE	此功能會安裝為從來源執行。

傳回值

MsiQueryFeatureStateEx 函式會傳回下列值。

值	意義
ERROR_ACCESS_DENIED	用戶必須具有系統管理許可權，才能取得目前使用者以外的使用者所安裝產品的資訊。
ERROR_BAD_CONFIGURATION	組態數據已損毀。
ERROR_INVALID_PARAMETER	無效的參數已傳遞至函式。
ERROR_SUCCESS	語言函式已順利完成。
ERROR_UNKNOWN_FEATURE	功能標識碼不會識別已知的功能。
ERROR_UNKNOWN_PRODUCT	產品代碼不會識別已知的產品。
ERROR_FUNCTION_FAILED	非預期的內部失敗。

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

備註

MsiQueryFeatureStateEx 函式不會驗證此功能是否可實際存取。 MsiQueryFeatureStateEx 函式不會驗證功能識別碼。 ERROR_UNKNOWN_FEATURE 會針對任何未知的功能標識碼傳回。當查詢安裝在目前使用者以外的用戶帳戶的每個使用者非受控內容下的產品時，函式會失敗。在此情況下，函式會傳回 ERROR_UNKNOWN_FEATURE，或者如果產品只會在未安裝) (公告，則會傳回 ERROR_UNKNOWN_PRODUCT 。

注意

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