Interface IRowsetEvents (searchapi.h)

Article
08/25/2023

Expose des méthodes pour recevoir des notifications d’événements. Lorsque les clients implémentent cette interface, l’indexeur peut informer les clients des modifications apportées aux éléments dans leurs ensembles de lignes : y compris l’ajout de nouveaux éléments, la suppression d’éléments et la modification des données d’élément.

Héritage

L’interface IRowsetEvents hérite de l’interface IUnknown. IRowsetEvents a également les types de membres suivants :

Méthodes

L’interface IRowsetEvents a ces méthodes.


IRowsetEvents::OnChangedItem Appelé par l’indexeur pour informer les clients qu’un élément a été modifié. Cet élément a peut-être correspondu à une partie (ou à la totalité) des critères de l’ensemble de lignes client.
IRowsetEvents::OnDeletedItem Appelé par l’indexeur pour informer les clients qu’un élément a été supprimé. Cet élément peut avoir correspondu à une partie (ou à la totalité) des critères de recherche de l’ensemble de lignes client.
IRowsetEvents::OnNewItem Appelé par l’indexeur pour informer les clients d’un nouvel élément qui peut correspondre à une partie (ou à la totalité) des critères de l’ensemble de lignes client.
IRowsetEvents::OnRowsetEvent Appelé par l’indexeur pour informer les clients d’un événement lié à l’ensemble de lignes du client.

Notes

Quand implémenter

Implémentez IRowsetEvents si votre fournisseur doit recevoir des notifications d’événements d’ensemble de lignes. IRowsetEvents expose des méthodes pour recevoir des notifications d’événements et doit être implémenté pour recevoir les notifications suivantes sur les événements : OnChangedItem, OnDeletedItem, OnNewItem et OnRowsetEvent. Les énumérateurs ROWSETEVENT_ITEMSTATE et ROWSETEVENT_TYPE capturent respectivement l’état de l’élément et l’événement d’ensemble de lignes.

Les événements d’indexeur sont une nouvelle fonctionnalité pour Windows 7 qui permet aux fournisseurs de recevoir des notifications sur leurs ensembles de lignes. Les fournisseurs peuvent utiliser l’événementing pour gérer leurs ensembles de lignes de manière à ce qu’ils se comportent comme des emplacements réels du système de fichiers.

L’interface IRowsetEvents est inscrite par point de connexion avec un ensemble de lignes d’indexeur ouvert.

DBPROP_ENABLEROWSETEVENTS devez avoir la valeur TRUE avec la méthode OLE DB ICommandProperties::SetProperties avant d’exécuter la requête afin d’utiliser les événements d’ensemble de lignes.

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	searchapi.h