GetFilter メソッド

供給されたパラメータに従って、適切なフィルタを取得します。

HRESULT GetFilter(
CLSID *pclsidObj,
LPCWSTR pcwszContentType,
LPCWSTR pcwszExtension,
IFilter **ppFilter
);

Parameters

pclsidObj

[入力] レジストリからのドキュメントの型のクラス ID (CLSID) へのポインタ。このポインタは、アイテムに埋め込まれたドキュメントに対して使用される適切なフィルタを示します。

pcwszContentType

[入力] ドキュメントの型を含む null で終わる Unicode 文字列へのポインタ。このポインタは、MIME (Multipurpose Internet Mail Extensions) タイプに従ってマップされるフィルタを取得するために使用します。

pcwszExtension

[入力] ファイル名の拡張子を含む null で終わる Unicode 文字列へのポインタ (拡張子の前のピリオドは含まれません)。このポインタは、指定したファイル名の拡張子にマップされるフィルタを取得するために使用します。

ppFilter

[出力] プロトコルハンドラで使用されるフィルタへのポインタのアドレス。

成功した場合は S_OK を、それ以外の場合はエラー値を返します。Microsoft Office SharePoint Server 2007 でのエンタープライズ検索によって返されるエラーメッセージについては、「プロトコルハンドラのエラーメッセージ」を参照してください。

プロトコルハンドラが、埋め込まれているドキュメント用のフィルタを必要とする場合は、このメソッドを使用することで、それを取得できます。このメソッドは、コンテンツのアイテムで使用する適切なフィルタ用のフィルタデーモンを必要とします。

フィルタの選択は、ファイル名の拡張子、レジストリ内のファイルの内容で識別された CLSID、または MIME コンテンツタイプに基づいて行われます。複数のパラメータを指定した場合、パラメータは次の順序でテストされます。

このメソッドは、最初の有効なパラメータを使用して適切なフィルタを選択します。それ以外のパラメータは無視されます。