IRowsetEvents-Schnittstelle (searchapi.h)

Artikel
08/25/2023

Macht Methoden zum Empfangen von Ereignisbenachrichtigungen verfügbar. Wenn Clients diese Schnittstelle implementieren, kann der Indexer die Clients über Änderungen an Elementen in ihren Rowsets benachrichtigen: einschließlich des Hinzufügens neuer Elemente, des Löschens von Elementen und der Änderung von Elementdaten.

Vererbung

Die IRowsetEvents-Schnittstelle erbt von der IUnknown-Schnittstelle . IRowsetEvents verfügt auch über folgende Membertypen:

Methoden

Die IRowsetEvents-Schnittstelle verfügt über diese Methoden.


IRowsetEvents::OnChangedItem Wird vom Indexer aufgerufen, um Clients zu benachrichtigen, dass ein Element geändert wurde. Dieses Element hat möglicherweise einige (oder alle) Kriterien für das Clientrowset erfüllt.
IRowsetEvents::OnDeletedItem Wird vom Indexer aufgerufen, um Clients zu benachrichtigen, dass ein Element gelöscht wurde. Dieses Element hat möglicherweise einige (oder alle) suchkriterien für das Clientrowset erfüllt.
IRowsetEvents::OnNewItem Wird vom Indexer aufgerufen, um Clients über ein neues Element zu benachrichtigen, das möglicherweise einigen (oder allen) kriterien für das Clientrowset entspricht.
IRowsetEvents::OnRowsetEvent Wird vom Indexer aufgerufen, um Clients über ein Ereignis im Zusammenhang mit dem Clientrowset zu benachrichtigen.

Hinweise

Wann sollte implementiert werden?

Implementieren Sie IRowsetEvents , wenn Ihr Anbieter Benachrichtigungen zu Rowsetereignissen empfangen muss. IRowsetEvents macht Methoden zum Empfangen von Ereignisbenachrichtigungen verfügbar und muss implementiert werden, um die folgenden Benachrichtigungen zu Ereignissen zu empfangen: OnChangedItem, OnDeletedItem, OnNewItem und OnRowsetEvent. Die ROWSETEVENT_ITEMSTATE- und ROWSETEVENT_TYPE-Enumeratoren erfassen den Elementzustand bzw. das Rowsetereignis.

Indexer-Ereigniserstellung ist ein neues Feature für Windows 7, mit dem Anbieter Benachrichtigungen für ihre Rowsets empfangen können. Anbieter können die Ereigniserstellung verwenden, um ihre Rowsets so zu verwalten, dass sie sich ähnlich wie die tatsächlichen Dateisystemspeicherorte verhalten.

Die IRowsetEvents-Schnittstelle wird vom Verbindungspunkt mit einem offenen Indexerrowset registriert.

DBPROP_ENABLEROWSETEVENTS muss mit der OLE DB-Methode ICommandProperties::SetProperties auf TRUE festgelegt werden, bevor die Abfrage ausgeführt wird, um rowsetereignising verwenden zu können.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	searchapi.h