共用方式為


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

另請參閱

ISearchNotifyInlineSite

通知索引變更