ISearchNotifyInlineSite::OnCatalogStatusChange メソッド (searchapi.h)
カタログの状態が変更されたときにクライアントに通知するために、検索サービスによって呼び出されます。
構文
HRESULT OnCatalogStatusChange(
[in] REFGUID guidCatalogResetSignature,
[in] REFGUID guidCheckPointSignature,
[in] DWORD dwLastCheckPointNumber
);
パラメーター
[in] guidCatalogResetSignature
型: REFGUID
カタログのリセットを表す GUID。 この GUID が変更された場合は、すべての通知を再送信する必要があります。
[in] guidCheckPointSignature
型: REFGUID
復元された最後のチェックポイントを表す GUID。 この GUID が変更された場合は、最後に保存されたチェックポイント以降に累積されたすべての通知を再送信する必要があります。
[in] dwLastCheckPointNumber
型: DWORD
最後に保存されたチェックポイントを示す数値。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
カタログ チェックポイントが発生すると、検索サービスは dwLastCheckPointNumber を更新し、そのチェックポイントの前に送信されたすべての通知は、サービス障害が発生した場合に安全かつ回復可能になります。 通知プロバイダーは、チェックポイント間で送信された通知のみを追跡する必要があり、カタログが復元またはリセットされた場合は再送信する必要があります。
カタログの復元が発生した場合、検索サービスはカタログを最後に保存したチェックポイントにロールバックし、 guidCheckPointSignature を更新します。 この状況では、通知プロバイダーは、 dwLastCheckPointNumber パラメーターで識別される、最後に保存されたチェックポイント以降に蓄積されたすべての通知を再送信する必要があります。
カタログのリセットが発生した場合、検索サービスはカタログ全体をリセットし、 guidCatalogResetSignature を更新します。 通知プロバイダーは、クロール スコープ全体を再送信する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | searchapi.h |
| 再頒布可能パッケージ | Windows デスクトップ検索 (WDS) 3.0 |