ISearchPersistentItemsChangedSink::StartedMonitoringScope メソッド (searchapi.h)

指定した階層スコープ内のアイテムに対する変更を監視するようにインデクサーに通知するために、通知プロバイダーによって呼び出されます。

構文

HRESULT StartedMonitoringScope(
  [in] LPCWSTR pszURL
);

パラメーター

[in] pszURL

種類: LPCWSTR

監視対象のスコープの開始アドレスである null で終わる Unicode 文字列へのポインター。

戻り値

種類: HRESULT

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

注釈

通知の損失が発生すると、通知エージェントがオンラインになり、 StartedMonitoringScope を呼び出します。これにより、インデックスで管理された通知ソースが "監視対象スコープ" の一覧に追加できるようになります。 インデクサーは、対応するドキュメント ストアの増分クロールを開始します。 インデクサーは、通知の損失の原因となった極端な条件が存在しなくなるまで、これらのスコープを段階的にクロールします。 この方法により、通知損失の期間中に発生したストア内の変更が確実に検出されます。

通常の状況では、監視対象のスコープの一覧は使用されません。 通知の損失はまれであり、通常はディスク領域が非常に少ない場合にのみ発生します。

要件

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