フィルターハンドラーの登録

[アーティクル]
06/13/2023

フィルターハンドラーを登録する必要があります。レジストリまたは ILoadFilter インターフェイスを使用して、特定のファイル名拡張子の既存のフィルターハンドラーを見つけることもできます。

このトピックは次のように整理されています。

Windows 検索用のフィルターハンドラーの登録
- フィルターハンドラーを登録するための古いアプローチ
既存のフィルターハンドラーの置き換え
特定のファイル拡張子のフィルターハンドラーを検索する
その他のリソース
関連トピック

Note

フィルターハンドラーは、 IFilter インターフェイスの実装です。

Windows 検索用のフィルターハンドラーの登録

新しいプロトコルハンドラーの登録または既存のプロトコルハンドラーの検索に必要な GUID を次の表に示します。

GUID	ユーザーまたはアプリケーションの定義	説明
89BCB740-6119-101A-BCB7-00DD010655AF	Application	IFilter インターフェイス GUID は、すべてのフィルターハンドラーのレジストリキー定数です。
{PersistentHandlerGUID}	User	これは永続的ハンドラーの GUID です。
{FilterHandlerCLSID}	User	これは、フィルターハンドラーのクラス識別子 (CLSID) です。
{ApplicationGUID}	User	これは中間 (集計) GUID です。

SearchFilterHost.exeが SYSTEM アカウントで実行されているため、ログオンしているユーザーのHKEY_CURRENT_USERのレジストリキーにアクセスできないため、フィルターハンドラーをHKEY_LOCAL_MACHINEに登録する必要があります。さらに、ユーザーグループは、フィルターハンドラー.dllそれ自体に対する読み取りと実行のアクセス権を持っている必要があります。これは、SearchFilterHost.exeはすべての管理者権限を削除し、管理者権限以外の権限のみを許可するためです。既定の Visual Studio プロジェクトの場所は現在のユーザーのディレクトリにあるため、Users グループに対する読み取りアクセス許可は付与されないため、.dllを移動するか、ACL を変更してSearchFilterHost.exeアクセスを許可する必要があります。

新しいフィルターハンドラーを登録するときは、わかりやすい名前 (HTML IFilter など) を使用することをお勧めします。

新しいフィルターハンドラーを登録するには:

フィルターハンドラーを使用する拡張ハンドラーと永続的ハンドラー GUID を指定します。

    HKEY_LOCAL_MACHINE
       Software
          Classes
             .txt
                PersistentHandler
                   (Default) = {PersistentHandlerGUID}

    HKEY_LOCAL_MACHINE
       Software
          Classes
             CLSID
                {PersistentHandlerGUID}
                   PersistentAddinsRegistered
                      {89BCB740-6119-101A-BCB7-00DD010655AF}l
                         (Default) = {FilterHandlerCLSID}

次のキーと値を使用してフィルターハンドラーを登録します。

    HKEY_LOCAL_MACHINE
       Software
          Classes
             CLSID
                {FilterHandlerCLSID}
                   (Default) = {DescriptiveFilterHandlerName}
                   InprocServer32
                      (Default) = DLL Install Path
                      ThreadingModel = Both

フィルターハンドラーを登録するための古いアプローチ

この方法は、使用することはお勧めしません。フィルターは、コンポーネントオブジェクトモデル (COM) クラスを表す CLSID、またはファイル名拡張子に対して登録できます。クラスのフィルターハンドラーを登録する必要がある場合は、両方のフィルターを登録し、クラス内のファイル名拡張子に対して別のフィルターハンドラーを登録できます。ファイル名拡張子に登録されたフィルターハンドラーは、CLSID のフィルターハンドラーよりも優先されることに注意してください。

これらのエントリは、 CLSID\{ApplicationGUID} クラスのエントリまでの標準 OLE レジストリエントリです。 DLL sample.dllは、.txt クラスの実行中のオブジェクト動作を実装します。追加のエントリ PersistentHandler をメモします。このエントリは、サンプルクラスの永続オブジェクトへの要求を仲介するクラスを指定します。 PersistentAddinsRegistered の下のエントリは、89BCB740-6119-101A-BCB7-00DD010655AF(IID_IFilter) という名前のインターフェイスを担当する実装を識別します。 IID_IFilterを実装するクラスには、標準の OLE レジストリエントリがあります。 InprocServer32 DLL は、標準の OLE メカニズムを介して読み込まれます。

Windows Search では、フィルターハンドラーに対して指定されたスレッドモデルが観察されます。スレッドモデルが Both に設定されている場合、フィルターハンドラーはスレッドセーフである必要があります。それ以外の場合は、スレッドセーフでない場合は、Apartment を指定 します。フィルターハンドラーは常にスレッドセーフである必要があることに注意してください。

次のレジストリエントリの例は、クラスとファイル名拡張子に登録されたフィルターハンドラー用です。 {PersistentHandlerGUID} と {FilterHandlerCLSID} は 、フィルターハンドラーの作成者が指定する必要がある値を示す変数として使用されます。値の型は REG_SZ です。

HKEY_LOCAL_MACHINE
   Software
      Classes
         .txt
            (Default) = SampleFile
         SampleFile
            (Default) = Class for Sample Files
            CLSID
               (Default) = {ApplicationGUID}
         CLSID
            {ApplicationGUID}
               (Default) = Sample Files
               InprocServer32
                  (Default) = sample.dll
               PersistentHandler
                  (Default) = {PersistentHandlerGUID}
            {PersistentHandlerGUID}
               (Default) = Sample file persistent handler
               PersistentAddinsRegistered
                  {89BCB740-6119-101A-BCB7-00DD010655AF}l
                     (Default) = {FilterHandlerCLSID}
            {FilterHandlerCLSID}
               (Default) = Sample Files
               InprocServer32
                  (Default) = sampfilt.dll
                  ThreadingModel = Both

既存のフィルターハンドラーの置き換え

.txt、.doc、.html、.url などの一般的なファイルの種類の組み込みフィルターハンドラーは置き換えないことをお勧めします。これは、他のシステムコンポーネントに望ましくない影響を及ぼす可能性があるためです。電子メールメッセージ本文のインデックス作成は、たとえば、.txt、.html、.rtf フィルターハンドラーによって異なります。

ファイルの種類の新しいフィルターハンドラーが既存のフィルター登録の代わりとしてインストールされている場合、インストーラーは現在の登録を保存し、新しいフィルターハンドラーがアンインストールされた場合に復元する必要があります。フィルターをチェーンするメカニズムはありません。そのため、新しいフィルターハンドラーは、古いフィルターの必要な機能をレプリケートする役割を担います。

特定のファイル拡張子のフィルターハンドラーを検索する

ILoadFilter インターフェイスを使用して、指定されたファイル名拡張子のフィルターハンドラーを見つけることができます。次のレジストリエントリの例は、HTML ファイルに対してこれを行う方法を示しています。この例では、HTML ドキュメントのフィルターハンドラーがnlhtml.dllされています。値の型は REG_SZ です。

指定されたファイル名拡張子のフィルターハンドラーを検索するには:

フィルター処理されるファイルの種類の拡張子に、レジストリエントリ \HKEY_LOCAL_MACHINE\SOFTWARE\Classes.extensionの下に永続的なハンドラーが登録されているかどうかを確認します。その場合は、このキーを {PersistentHandlerGUID} にします。

    HKEY_LOCAL_MACHINE
       SOFTWARE
          Classes
             .htm
                PersistentHandler
                   {PersistentHandlerGUID}

拡張機能に永続的なハンドラーが登録されていない場合は、レジストリエントリ \HKEY_LOCAL_MACHINE\SOFTWARE\Classesで、ドキュメントの種類に関連付けられている CLSID を見つけます。このキーを {ApplicationGUID} に設定します。次に、CLSID に永続的ハンドラーが登録されているかどうかを確認します。{ApplicationGUID} を使用して、\HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{ApplicationGUID} エントリの永続ハンドラーを見つけます。このキーを {PersistentHandlerGUID} に設定します。

    HKEY_LOCAL_MACHINE
       SOFTWARE
          Classes
             htmlfile
                (Default) = Class for WWW HTML files
                CLSID
                   (Default) = {25336920-03F9-11CF-8FD0-00AA00686F13}
             CLSID
                {25336920-03F9-11CF-8FD0-00AA00686F13}
                   PersistentHandler
                      (Default) = {PersistentHandlerGUID}

永続的ハンドラーの GUID を確認します。{PersistentHandlerGUID} を使用して、ドキュメントの種類の永続的なハンドラー GUID を見つけます。レジストリエントリHKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{PersistentHandlerGUID}\PersistentAddinsRegistered\ 89BCB740-6119-101A-BCB7-00DD010655AF の値は、このドキュメントの種類の永続的なハンドラー GUID を生成します。このキーを {FilterHandlerCLSID} に設定します。

    HKEY_LOCAL_MACHINE
       SOFTWARE
          Classes
             {PersistentHandlerGUID}
                (Default) = HTML File Persistent Handler<dl>
                    REG_SZ     {89BCB740-6119-101A-BCB7-00DD010655AF}
                    REG_SZ     (Default) = {EEC97550-47A9-11CF-B952-00AA0051FE20}

フィルターハンドラーを決定する: 前の手順で決定した {FilterHandlerCLSID} を使用して、エントリ \HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{FilterHandlerCLSID}\InprocServer32の下にあるフィルターハンドラーを見つけます。この例では、使用されるわかりやすいフィルターハンドラー名は HTML IFilter です。

    HKEY_LOCAL_MACHINE
       SOFTWARE
          Classes
             CLSID
                {EEC97550-47A9-11CF-B952-00AA0051FE20}
                   (Default) = HTML IFilter
                    Data type  REG_SZ
                    InprocServer32
                    nlhtml.dll

その他のリソース

GitHub で入手できる IFilterSample コードサンプルは、IFilter インターフェイスを実装するための IFilter 基本クラスを作成する方法を示しています。
インデックス作成プロセスの概要については、「インデックス作成プロセス」を参照してください。
ファイルの種類の概要については、「ファイルの種類」を参照してください。
ファイルの種類のファイル関連付け属性を照会するには、「 PerceivedTypes、SystemFileAssociations、およびアプリケーション登録」を参照してください。