IProtocolHandlerSite::GetFilter メソッド (searchapi.h)

指定されたパラメーターに従って、適切な IFilter を取得します。

構文

HRESULT GetFilter(
  [in]  CLSID   *pclsidObj,
  [in]  LPCWSTR pcwszContentType,
  [in]  LPCWSTR pcwszExtension,
  [out] IFilter **ppFilter
);

パラメーター

[in] pclsidObj

種類: CLSID*

レジストリからのドキュメントの種類の CLSID へのポインター。 これは、埋め込みドキュメントを含むアイテムで、その埋め込みドキュメントに使用する適切な IFilter を示すために使用されます。

[in] pcwszContentType

種類: LPCWSTR

ドキュメントの型を含む null で終わる Unicode 文字列へのポインター。 これは、MIME の種類に従ってマップされた IFilterを 取得するために使用されます。

[in] pcwszExtension

種類: LPCWSTR

ファイル名拡張子を含む null で終わる Unicode 文字列へのポインター。前のピリオドはありません。 これは、ファイル名拡張子に従ってマップされた IFilter オブジェクトを取得するために使用されます。

[out] ppFilter

種類: IFilter**

プロトコル ハンドラーが使用する IFilter へのポインターのアドレスを受け取ります。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このメソッドは、フィルター ホストに対してクエリを実行して、URL 項目に使用する適切な IFilter オブジェクトを識別します。

フィルターの選択は、ファイル名拡張子、レジストリ内のファイルのコンテンツ タイプを識別する CLSID、または MIME コンテンツ タイプに基づいています。 このメソッドには、3 つのパラメーターのうち 1 つだけを指定する必要があります。 複数のパラメーターを指定すると、 pcwszContentType、 pclsidObj、 pcwszExtension の順序でテストされます。 最初の有効なパラメーターは、適切な IFilter を選択するために使用されます。その他は無視されます。

要件

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