(searchapi.h) IRowsetEvents 介面
公開接收事件通知的方法。 當用戶端實作此介面時,索引子可以通知用戶端其資料列集中的專案變更:包括新增專案、刪除專案,以及專案資料的修改。
繼承
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介面是由連接點向開放式索引子資料列集注冊。
DBPROP_ENABLEROWSETEVENTS必須先使用 OLE DB ICommandProperties::SetProperties方法設定為TRUE,才能執行查詢,才能使用資料列集事件。
需求
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | searchapi.h |
另請參閱
概念
參考