MsiQueryFeatureStateExA 函式（msi.h）

發行項
11/20/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），在其中，要查詢的產品實例存在。如果 dwContext 不是 MSIINSTALLCONTEXT_MACHINE，則 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 需求。
目標平臺	窗戶
標頭	msi.h
連結庫	Msi.lib
DLL	Msi.dll