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 |