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 modifcation to item data.
The IRowsetEvents interface inherits from the IUnknown interface. IRowsetEvents also has these types of members:
The IRowsetEvents interface has these methods.
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.
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.
Called by the indexer to notify clients of a new item that may match some (or all) of the criteria for the client rowset.
Called by the indexer to notify clients of an event related to the client rowset.
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 enumeratiors 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.
Minimum supported client
|Windows 7 [desktop apps only]|
Minimum supported server
|Windows Server 2008 R2 [desktop apps only]|
- Rowset Properties
- Indexing Prioritization and Rowset Events in Windows 7
- Notifications Process (Windows Search)