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

通知索引更改