iRowsetEvents 接口 (searchapi.h)

项目
08/25/2023

公开用于接收事件通知的方法。当客户端实现此接口时，索引器可以通知客户端对其行集中的项所做的更改：包括添加新项、删除项以及修改项数据。

继承

IRowsetEvents 接口继承自 IUnknown 接口。 IRowsetEvents 还具有以下类型的成员：

方法

IRowsetEvents 接口包含以下方法。


IRowsetEvents：：OnChangedItem 由索引器调用，以通知客户端项已修改。此项可能已匹配客户端行集条件的某些 (或所有) 。
IRowsetEvents：：OnDeletedItem 由索引器调用，以通知客户端某个项已被删除。此项可能已匹配客户端行集的搜索条件的某些 (或所有) 。
IRowsetEvents：：OnNewItem 由索引器调用，以通知客户端新项可能与客户端行集条件的某些 (或所有) 匹配。
IRowsetEvents：：OnRowsetEvent 由索引器调用，以通知客户端与客户端行集相关的事件。

注解

何时实现

如果提供程序需要接收行集事件的通知，请实现 IRowsetEvents 。 IRowsetEvents 公开用于接收事件通知的方法，必须实现以接收以下事件通知： OnChangedItem、 OnDeletedItem、 OnNewItem 和 OnRowsetEvent。 ROWSETEVENT_ITEMSTATE和ROWSETEVENT_TYPE枚举器分别捕获项状态和行集事件。

索引器事件是 Windows 7 的一项新功能，允许提供程序在其行集上接收通知。提供程序可以使用事件来维护其行集，其行为类似于实际的文件系统位置。

IRowsetEvents 接口由连接点使用打开的索引器行集进行注册。

在执行查询之前，必须使用 OLE DB ICommandProperties：：SetProperties 方法将DBPROP_ENABLEROWSETEVENTS设置为 TRUE，才能使用行集事件。

要求


最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	searchapi.h