検索プロトコルの使用

search: アプリケーション プロトコル は、Windows Vista Service Pack 1 (SP1) 以降のバージョンでデスクトップ検索アプリケーションを呼び出すための拡張可能な規則です。 このプロトコルは、Windows Vista SP1 で作成され、Windows が既定のデスクトップ検索アプリケーションを決定して呼び出すことができるようになりました。

プロトコル構文は、ユーザーが入力した検索用語や検索を開始した場所など、一般的なデスクトップ検索を実行するのに役立ついくつかのパラメータを提供します。 ユーザーが 2 つの利用可能な検索エントリ ポイント (スタート メニューまたは Windows Explorer) のいずれかから検索すると、オペレーティング システムは検索プロトコルを使用して既定のデスクトップ検索アプリケーションを起動します。 これは、ユーザーが入力した検索用語を標準の検索プロトコル構文に追加し、その情報をデフォルトの検索アプリケーションとして登録されているアプリケーションに渡すことによって行われます。

他のデスクトップ検索アプリケーションがインストールされていない場合、これらのエントリ ポイントに検索を入力すると、Windows Search Explorer が起動します。 ただし、サードパーティの開発者は、検索プロトコルを処理し、デフォルトの検索アプリケーションとなるアプリケーションを作成、インストール、登録することができます。 このようなアプリケーションは、Windows とのシームレスなエクスペリエンスを確保するために、検索プロトコル構文をサポートし、 既定のプログラム 機能に登録する必要があります。

特定のデスクトップ検索アプリケーションを使用するか、その上に構築することを目的としたアプリケーションを開発する場合は、search: プロトコルのみに依存しないでください。 多くのアプリケーションが search: プロトコルを所有している可能性があるため、対象のデスクトップ検索アプリケーションが常にこのプロトコルを所有しているという保証はありません。 代わりに、対象のデスクトップ検索アプリケーションによって定義されたプライベート検索プロトコルを使用する必要があります。 つまり、サードパーティ アプリケーションのプラットフォームとなることを意図したデスクトップ検索アプリケーションは、 search: プロトコルと独自の検索プロトコルの両方をサポートする必要があります。

このトピックでは、以下の内容を説明します。

• 構文
• Windows Vista SP1 での検索の使用: プロトコル
• 使用例
• プロトコルを処理するアプリケーションの登録
  • レジストリ エントリ
• 関連トピック

構文

検索プロトコルでは、次の標準の URL エンコード構文が使用されます。

search:parameter=value[&parameter=value]&

構文はプロトコル自体を識別することから始まります (search:)。 パラメータ/値のペアは、検索エンジンに渡される引数です。次の表に、検索プロトコル構文で使用可能なすべてのパラメータを示します。

Windows Vista SP1 での検索の使用: プロトコル

Windows Vista SP1 には、 search: プロトコルを呼び出すエントリ ポイントがいくつかあります。 これらのエントリ ポイントと、それぞれに関連付けられた共通の構文の概要を次に示します。

Windows Vista SP1 の検索プロトコル エントリ ポイントでは、検索プロトコルで使用可能なすべてのパラメータが活用されるわけではありません。 Windows Vista SP1 からの検索プロトコル呼び出しの処理のみに関係するアプリケーションでは、実装する必要のある最小限の要素のガイドとして次の表を使用できます。

例

ユーザーが [スタート] メニューに「Microsoft」と入力し、 [どこでも検索] をクリックすると、次のような検索プロトコル呼び出しが行われます。

search:query=microsoft&

ユーザーが Windows Explorer の C:\MyFolder 内で「Seattle」と入力し、 [すべての場所を検索] をクリックすると、':' と '\' のエスケープ文字を使用して次の呼び出しが行われます。

search:query=seattle&crumb=location:C%3A%5CMyFolder

プロトコルを処理するアプリケーションの登録

複数のアプリケーションが検索プロトコルを競合する可能性があるため、インストール中にアプリケーションを 既定のプログラム 機能に登録して、ユーザーが既定値をより簡単に構成できるようにする必要があります。 Windows XP で通常実行されるインストール手順に加えて、Windows Vista ベースのアプリケーションは、アプリケーションとユーザーがシームレスにデフォルトを構成できるように、既定のプログラム機能に登録する必要があります。

必要なバイナリ ファイルをユーザーのコンピューターにインストールした後、インストール ルーチンは次の一般的なタスクを完了する必要があります。

1. 下記の説明に従って、ProgID を HKEY_LOCAL_MACHINE に書き込みます。 アプリケーションは、検索プロトコル用にアプリケーション固有の ProgID を作成する必要があることに注意してください。
2. マシンレベルの検索プロトコルの関連付けを要求します。
3. 「デフォルト プログラムで使用するためのアプリケーションの登録」で説明されているように、検索プロトコルの候補として、アプリケーションを デフォルト プログラムに登録します。

レジストリ エントリ

以下は、架空のデスクトップ検索アプリケーション Contoso Search に必要なレジストリ エントリの例です。

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            URL Protocol = ""

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            DefaultIcon
               (Default) = %ProgramFiles%\Contoso\Search\contososearch.exe,-7

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            shell
               open
                  command
                     (Default) = %ProgramFiles%\Contoso\Search\contososearch.exe %1

HKEY_LOCAL_MACHINE
   SOFTWARE
      RegisteredApplications
         Contoso Search = "Software\\Contoso\\Search\\Capabilities"

HKEY_LOCAL_MACHINE
   SOFTWARE
      Contoso
         Search
            Capabilities
               ApplicationName = "Contoso Search Test App"
               ApplicationDescription = "Contoso search is a great new desktop search application"

HKEY_LOCAL_MACHINE
   SOFTWARE
      Contoso
         Search
            Capabilities
               UrlAssociations
                  search = "contoso-search"

関連トピック

詳細クエリ構文

既定のプログラム