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
Indexing Prioritization and Rowset Events in Windows 7
Notifications Process (Windows Search)
Reference