IFilter::Init メソッド (filter.h)

[アーティクル]
08/23/2023

注意

Indexing Service は Windows XP 以降サポートされなくなり、Windows 8時点では使用できません。代わりに、クライアント側検索には Windows Search を使用し、サーバー側の検索には Microsoft Search Server Express を使用します。

フィルター処理セッションを初期化します。

構文

SCODE Init(
  [in]  ULONG              grfFlags,
  [in]  ULONG              cAttributes,
  [in]  const FULLPROPSPEC *aAttributes,
  [out] ULONG              *pFlags
);

パラメーター

[in] grfFlags

テキストの標準化、プロパティ出力、埋め込みスコープ、および IFilter アクセスパターンを制御するためのIFILTER_INIT列挙の値。

[in] cAttributes

属性配列のサイズ。 0 以外の場合、 cAttributes は grfFlags で指定された属性よりも優先されます。属性フラグが指定されておらず、cAttributes が 0 の場合、既定値は PSGUID_STORAGE ストレージプロパティセットによって指定されます。このプロパティには、ファイルへの最後の書き込みの日時、サイズなどが含まれます。とは、ファイルのメインコンテンツにマップされる PID_STG_CONTENTS 'contents' プロパティによって。プロパティとプロパティセットの詳細については、「プロパティセット」を参照してください。

[in] aAttributes

要求されたプロパティの FULLPROPSPEC 構造体の配列へのポインター。 cAttributes が 0 以外の場合、aAttributes 内のプロパティのみが返されます。

[out] pFlags

呼び出し元が使用できる追加のプロパティに関する情報。をIFILTER_FLAGS 列挙から取得します。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	操作は正常に完了しました。
E_fail	フィルター処理するファイルが以前に読み込まれていませんでした。
E_INVALIDARG	属性のカウントと内容が一致しません。
FILTER_E_PASSWORD	パスワード保護または同様のセキュリティ対策により、アクセスが拒否されました。
FILTER_E_ACCESS	一般的なアクセスエラー

注釈

Init メソッドは、フィルターオブジェクトの状態を設定します。コンテンツフィルターはオブジェクトの先頭に位置し、オブジェクトの状態はオブジェクトが解放されるまで固定されます。 aAttributes 配列でプロパティセットとプロパティ識別子 (ID) の説明を設定することで、返されるプロパティのセットをフィルターオブジェクトに渡すことができます。詳細については、「ファイルのプロパティのフィルター処理」を参照してください。

呼び出し元へのメモ

他のすべての IFilter メソッドを呼び出す前に、Init メソッドを呼び出します。

実装者へのメモ

チャンク ID は、同じパラメーターを持つ Init メソッドに対する複数の呼び出しで一貫性を保つ必要があります。

IFilter インターフェイスの一部の実装では、Init メソッドが呼び出されるまで、ドキュメントにアクセスできない (または計算コストが高くなる可能性があります) 可能性があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	filter.h