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 类型。

仅当函数实例的 PKEY 的 PROPVARIANT 类型与约束的 PKEY 的 PROPVARIANT 类型匹配，并且函数实例的 PKEY 值使用 enumPropertyConstraint 指定的比较运算符匹配约束的 PKEY 值时，函数实例才会匹配属性约束。

如果添加了多个约束，则必须支持所有约束才能满足查询。