ISearchQueryHelper インターフェイス (searchapi.h)

ユーザー入力からクエリを作成し、クエリを Windows Search SQL に変換し、ウィンドウ検索インデックスへの接続を初期化する接続文字列を取得するメソッドを提供します。

継承

ISearchQueryHelper インターフェイスは、IUnknown インターフェイスから継承されます。 ISearchQueryHelper には、次の種類のメンバーもあります。

メソッド

ISearchQueryHelper インターフェイスには、これらのメソッドがあります。

ISearchQueryHelper::GenerateSQLFromUserQuery 高度なクエリ構文 (AQS) または自然クエリ構文 (NQS) で表されるクライアント指定のクエリ文字列に基づいて、構造化照会言語 (SQL) クエリを生成します。
ISearchQueryHelper::get_ConnectionString ウィンドウ検索インデックスの OLE DB 接続文字列を返します。
ISearchQueryHelper::get_QueryContentLocale クエリの言語コード識別子 (LCID) を取得します。
ISearchQueryHelper::get_QueryContentProperties 検索語句でプロパティが明示的に指定されていない場合に、クエリに含まれるプロパティの一覧を取得します。
ISearchQueryHelper::get_QueryKeywordLocale 高度なクエリ構文 (AQS) キーワードを解析するときに使用するロケールの言語コード識別子 (LCID) を取得します。
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 へのヘルパー クラスとしてこのインターフェイスを実装します。

このインターフェイスを使用すると、高度なクエリ構文 (AQS) または自然クエリ構文 (NQS) を使用して SQL クエリを生成できます。 クライアントは、OLE DB または Microsoft ActiveX Data Objects (ADO) を使用して、ウィンドウ検索エンジンに SQL クエリを送信できます。

ISearchQueryHelper::GenerateSQLFromUserQuery は 、地域のロケール設定を使用します。 ただし、 ISearchQueryHelper では地域のロケール設定は使用されません。 その結果、たとえば、 ISearchQueryHelper::GenerateSQLFromUserQuery と ISearchQueryHelper から返される SQL では、日付形式などのリージョン固有の設定に不整合があります。

ISearchQueryHelper の Microsoft.Search.Interop アセンブリを使用して Windows Search にクエリを実行する静的コンソール アプリケーションのクラスを作成する方法を示すサンプルについては、DSearch サンプルを参照してください。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	searchapi.h
再頒布可能パッケージ	Windows デスクトップ検索 (WDS) 3.0

こちらもご覧ください

プログラムによるインデックスのクエリ

Windows Search SQL 構文を使用したインデックスのクエリ