IFilter::Init メソッド (filter.h)
注意
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 列挙から取得します。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
操作は正常に完了しました。 |
|
フィルター処理するファイルが以前に読み込まれていませんでした。 |
|
属性のカウントと内容が一致しません。 |
|
パスワード保護または同様のセキュリティ対策により、アクセスが拒否されました。 |
|
一般的なアクセス エラー |
注釈
Init メソッドは、フィルター オブジェクトの状態を設定します。 コンテンツ フィルターはオブジェクトの先頭に位置し、オブジェクトの状態はオブジェクトが解放されるまで固定されます。 aAttributes 配列でプロパティ セットとプロパティ識別子 (ID) の説明を設定することで、返されるプロパティのセットをフィルター オブジェクトに渡すことができます。 詳細については、「 ファイルのプロパティのフィルター処理」を参照してください。
呼び出し元へのメモ
他のすべての IFilter メソッドを呼び出す前に、Init メソッドを呼び出します。実装者へのメモ
チャンク ID は、同じパラメーターを持つ Init メソッドに対する複数の呼び出しで一貫性を保つ必要があります。IFilter インターフェイスの一部の実装では、Init メソッドが呼び出されるまで、ドキュメントにアクセスできない (または計算コストが高くなる可能性があります) 可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | filter.h |