iRowsetEvents 接口 (searchapi.h)
公开用于接收事件通知的方法。 当客户端实现此接口时,索引器可以通知客户端对其行集中的项所做的更改:包括添加新项、删除项以及修改项数据。
继承
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 |
请参阅
概念性
引用