共用方式為


msiQueryFeatureStateExA 函式 (msi.h)

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 (系統) 無法用來列舉依機器安裝的產品功能。 如果 dwContextMSIINSTALLCONTEXT_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

另請參閱

顯示的錯誤訊息

功能數據表

MsiQueryFeatureState

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

ProductCode

系統狀態函式