(searchapi.h) IRowsetEvents 介面

公開接收事件通知的方法。 當用戶端實作此介面時,索引子可以通知用戶端其資料列集中的專案變更:包括新增專案、刪除專案,以及專案資料的修改。

繼承

IRowsetEvents介面繼承自IUnknown介面。 IRowsetEvents 也有下列類型的成員:

方法

IRowsetEvents介面具有這些方法。

 
IRowsetEvents::OnChangedItem

由索引子呼叫,以通知用戶端已修改專案。 此專案可能符合用戶端資料列集的一些 (或所有) 準則。
IRowsetEvents::OnDeletedItem

由索引子呼叫,通知用戶端專案已刪除。 此專案可能符合用戶端資料列集的一些 (或所有) 。
IRowsetEvents::OnNewItem

由索引子呼叫,以通知用戶端是否有可能符合用戶端資料列集之準則的某些 (或所有) 的新專案。
IRowsetEvents::OnRowsetEvent

由索引子呼叫,以通知用戶端與用戶端資料列集相關的事件。

備註

何時實作

如果您的提供者需要接收資料列集事件的通知,請實作 IRowsetEventsIRowsetEvents 會公開接收事件通知的方法,而且必須實作才能接收下列事件通知: OnChangedItemOnDeletedItemOnNewItemOnRowsetEventROWSETEVENT_ITEMSTATEROWSETEVENT_TYPE列舉值分別擷取專案狀態和資料列集事件。

索引子事件是 Windows 7 的新功能,可讓提供者在其資料列集上接收通知。 提供者可以使用事件來維護其資料列集,使其行為類似于實際的檔案系統位置。

IRowsetEvents介面是由連接點向開放式索引子資料列集注冊。

DBPROP_ENABLEROWSETEVENTS必須先使用 OLE DB ICommandProperties::SetProperties方法設定為TRUE,才能執行查詢,才能使用資料列集事件。

需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 searchapi.h

另請參閱

概念

IRowsetPrioritization

在 Windows 7 中編制優先順序和資料列集事件的索引

通知程式 (Windows 搜尋)

PRIORITIZE_FLAGS

PRIORITY_LEVEL

ROWSETEVENT_ITEMSTATE

ROWSETEVENT_TYPE

參考

資料列集屬性