Метод 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 с пакетом обновления 2 (SP2), Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | searchapi.h |
| Распространяемые компоненты | Windows Desktop Search (WDS) 3.0 |