[函数发现可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]
AddQueryConstraint 方法向查询添加查询约束。
此方法使应用程序能够将结果集筛选为仅满足此约束的实例。
语法
HRESULT AddQueryConstraint(
[in] const WCHAR *pszConstraintName,
[in] const WCHAR *pszConstraintValue
);
参数
[in] pszConstraintName
查询约束。
[in] pszConstraintValue
约束值。
返回值
可能的返回值包括但不限于以下值。
| 返回代码 | 说明 |
|---|---|
|
该方法已成功完成。 |
|
方法无法分配执行此操作所需的内存。 |
注解
如果添加了多个约束，则必须支持所有约束才能满足查询。
如果 IFunctionInstanceCollectionQuery 对象包含所有子类别，并且调用 AddQueryConstraint 方法且 pszConstraintName 参数设置为 FD_QUERYCONSTRAINT_PROVIDERINSTANCEID，则 AddQueryConstraint 将失败并出现错误。 若要避免此错误，请创建不包含所有子类别的 IFunctionInstanceCollectionQuery 对象。 可以通过调用 CreateInstanceCollectionQuery 创建此类对象，并将 fIncludeAllSubCategories 参数设置为 false。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | functiondiscoveryapi.h |
| DLL | FunDisc.dll |