IRowsetEvents interface (searchapi.h)

Exposes methods for receiving event notifications. When clients implement this interface, the indexer can notify the clients of changes to items in their rowsets: including the addition of new items, the deletion of items, and the modification to item data.

Inheritance

The IRowsetEvents interface inherits from the IUnknown interface. IRowsetEvents also has these types of members:

Methods

The IRowsetEvents interface has these methods.

 
IRowsetEvents::OnChangedItem

Called by the indexer to notify clients that an item has been modified. This item may have matched some (or all) of the criteria for the client rowset.
IRowsetEvents::OnDeletedItem

Called by the indexer to notify clients that an item has been deleted. This item may have matched some (or all) of the search criteria for the client rowset.
IRowsetEvents::OnNewItem

Called by the indexer to notify clients of a new item that may match some (or all) of the criteria for the client rowset.
IRowsetEvents::OnRowsetEvent

Called by the indexer to notify clients of an event related to the client rowset.

Remarks

When to Implement

Implement IRowsetEvents if your provider needs to receive notifications of rowset events. IRowsetEvents exposes methods for receiving event notifications, and must be implemented to receive the following notifications on events: OnChangedItem, OnDeletedItem, OnNewItem and OnRowsetEvent. The ROWSETEVENT_ITEMSTATE and ROWSETEVENT_TYPE enumerators capture the item state and rowset event, respectively.

Indexer eventing is a new feature for Windows 7 that allows providers to receive notifications on their rowsets. Providers can use eventing to maintain their rowsets in such a way that they behave akin to actual file system locations.

The IRowsetEvents interface is registered by connection point with an open indexer rowset.

DBPROP_ENABLEROWSETEVENTS must be set to TRUE with the OLE DB ICommandProperties::SetProperties method prior to executing the query in order to use rowset eventing.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header searchapi.h

See also

Conceptual

IRowsetPrioritization

Indexing Prioritization and Rowset Events in Windows 7

Notifications Process (Windows Search)

PRIORITIZE_FLAGS

PRIORITY_LEVEL

ROWSETEVENT_ITEMSTATE

ROWSETEVENT_TYPE

Reference

Rowset Properties