IFunctionInstanceCollectionQuery：：AddPropertyConstraint 方法 (functiondiscoveryapi.h)

[函式探索可用於需求一節中指定的作業系統。它可能會在後續版本中改變或無法使用。]

將屬性條件約束加入至查詢。

此方法只會將查詢結果限制為只有屬性索引鍵 (PKEY 的函式實例，) 符合指定的條件約束。

語法

HRESULT AddPropertyConstraint(
  [in] REFPROPERTYKEY     Key,
  [in] const PROPVARIANT  *pv,
  [in] PropertyConstraint enumPropertyConstraint
);

[in] Key

條件約束的屬性索引鍵 (PKEY) 。如需 PKEY 的詳細資訊，請參閱金鑰定義。

[in] pv

用於條件約束的 PROPVARIANT 。此類型必須符合與 Key相關聯的 PROPVARIANT 類型。

下列顯示可能的值。請注意，只能使用內建提供者所支援的 PROPVARIANT 類型子集做為屬性條件約束。

VT_BOOL

VT_I2

VT_I4

VT_I8

VT_INT

VT_LPWSTR

VT_LPWSTR|VT_VECTOR

VT_UI2

VT_UI4

VT_UI8

VT_UINT

[in] enumPropertyConstraint

PropertyConstraint值，指定比較準則約束的 PKEY 與函式實例的 PKEY 時要使用的比較類型。

可能的傳回值包括，但不限於下列各項。

傳回碼	描述
S_OK	已成功完成命令。
E_OUTOFMEMORY	方法無法配置執行這項作業所需的記憶體。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)	不支援為查詢指定的條件約束。特定 VARENUM 類型不支援條件約束，或完全不支援 VARENUM 類型。

函式實例只有在函式實例的 PROPVARIANT 類型符合條件約束 PKEY 的 PROPVARIANT 類型時，函式實例的 PKEY 值才會比對屬性條件約束，而函式實例的 PKEY 值會使用 enumPropertyConstraint所指定的比較運算子來比對條件約束的 PKEY 值。

如果加入多個條件約束，則必須支援所有條件約束來滿足查詢。

此頁面對您有幫助嗎？