Поделиться через

Метод 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

См. также раздел

ISearchNotifyInlineSite

Уведомление индекса об изменениях