(searchapi.h) ISearchQueryHelper 介面

提供從使用者輸入建置查詢、將查詢轉換成 Windows 搜尋 SQL，以及取得 連接字串 以初始化視窗搜尋索引連線的方法。

繼承

ISearchQueryHelper 介面繼承自 IUnknown 介面。 ISearchQueryHelper 也有下列類型的成員：

方法

ISearchQueryHelper 介面具有這些方法。

ISearchQueryHelper：：GenerateSQLFromUserQuery 根據以進階查詢語法 (AQS) 或 NQS) 表示的用戶端提供的查詢字串，產生 結構化查詢語言 (SQL) (SQL) (查詢。
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 在剖析進階查詢語法 (AQS) 關鍵詞時，設定地區設定 (LCID) 的語言代碼識別符。
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 的協助程序類別。

此介面可協助使用進階查詢語法產生 SQL 查詢， (AQS) 或自然查詢語法 (NQS) 。 用戶端可以使用 OLE DB 或 Microsoft ActiveX Data Objects (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 語法查詢索引