Export (0) Print
Expand All

IRowsetEvents interface

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.

Members

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

Methods

The IRowsetEvents interface has these methods.

MethodDescription
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.

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.

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.

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 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.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Searchapi.h

IDL

Searchquery.idl

See also

Reference
IRowsetPrioritization
PRIORITY_LEVEL
PRIORITIZE_FLAGS
ROWSETEVENT_ITEMSTATE
ROWSETEVENT_TYPE
Rowset Properties
Conceptual
Indexing Prioritization and Rowset Events in Windows 7
Notifications Process (Windows Search)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft