ISearchQueryHelper 接口 (searchapi.h)

提供从用户输入生成查询、将查询转换为 Windows 搜索 SQL 以及获取用于初始化与窗口搜索索引连接的连接字符串的方法。

继承

ISearchQueryHelper 接口继承自 IUnknown 接口。 ISearchQueryHelper 还具有以下类型的成员：

方法

ISearchQueryHelper 接口具有这些方法。

ISearchQueryHelper：：GenerateSQLFromUserQuery 基于客户端提供的查询字符串生成结构化查询语言 (SQL) 查询，该字符串以高级查询语法 (AQS) 或自然查询语法 (NQS) 表示。
ISearchQueryHelper：：get_ConnectionString 返回窗口搜索索引的 OLE DB 连接字符串。
ISearchQueryHelper：：get_QueryContentLocale 获取查询 (LCID) 的语言代码标识符。
ISearchQueryHelper：：get_QueryContentProperties 获取搜索词未显式指定属性时查询中包含的属性列表。
ISearchQueryHelper：：get_QueryKeywordLocale 获取语言代码标识符 (LCID) ，以便在分析高级查询语法 (AQS) 关键字时要使用的区域设置。
ISearchQueryHelper：：get_QueryMaxResults 获取查询要返回的最大结果数。
ISearchQueryHelper：：get_QuerySelectColumns 获取查询的 SELECT 语句中) 请求的列 (或属性。
ISearchQueryHelper：：get_QuerySorting 获取查询结果集的排序顺序。
ISearchQueryHelper：：get_QuerySyntax 获取查询的语法。
ISearchQueryHelper：：get_QueryTermExpansion 获取值，该值指定如何扩展查询词。
ISearchQueryHelper：：get_QueryWhereRestrictions 获取在 WHERE 子句中追加到查询的限制。
ISearchQueryHelper：:p ut_QueryContentLocale 设置查询) LCID (语言代码标识符。
ISearchQueryHelper：:p ut_QueryContentProperties 设置搜索词未显式指定属性时要包含在查询中的属性。
ISearchQueryHelper：:p ut_QueryKeywordLocale 设置语言代码标识符 (LCID) ，以便在分析高级查询语法 (AQS) 关键字时使用的区域设置。
ISearchQueryHelper：:p ut_QueryMaxResults 设置查询要返回的最大结果数。
ISearchQueryHelper：:p ut_QuerySelectColumns 设置 select 语句中请求的列 (或属性) 。
ISearchQueryHelper：:p ut_QuerySorting 设置查询结果集的排序顺序。
ISearchQueryHelper：:p ut_QuerySyntax 设置查询的语法。
ISearchQueryHelper：:p ut_QueryTermExpansion 设置一个值，该值指定如何扩展查询词。
ISearchQueryHelper：:p ut_QueryWhereRestrictions 设置在 WHERE 子句中追加到查询的限制。
ISearchQueryHelper：：WriteProperties 未实现。 (ISearchQueryHelper.WriteProperties)

注解

此接口是通过调用 ISearchCatalogManager：：GetQueryHelper 获取的。 将此接口作为帮助程序类实现到 ISearchCatalogManager。

此接口使用高级查询语法 (AQS) 或自然查询语法 (NQS) 来促进 SQL 查询的生成。 客户端可以使用 OLE DB 或 Microsoft ActiveX 数据对象 (ADO) 将 SQL 查询提交到窗口搜索引擎。

ISearchQueryHelper：：GenerateSQLFromUserQuery 使用区域设置。 但是， ISearchQueryHelper 不使用区域设置。 因此，对于区域特定设置（例如日期格式）， 从 ISearchQueryHelper：：GenerateSQLFromUserQuery 和 ISearchQueryHelper 返回的 SQL 中存在不一致。

有关演示如何为静态控制台应用程序创建类以使用 适用于 ISearchQueryHelper 的 Microsoft.Search.Interop 程序集查询 Windows 搜索的示例，请参阅 DSearch 示例。

要求

要求	值
最低受支持的客户端	Windows XP SP2、Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 SP1 [仅限桌面应用]
目标平台	Windows
标头	searchapi.h
可再发行组件	Windows 桌面搜索 (WDS) 3.0

另请参阅

以编程方式查询索引

使用 Windows 搜索 SQL 语法查询索引