Interfaz IRowsetEvents (searchapi.h)
Expone métodos para recibir notificaciones de eventos. Cuando los clientes implementan esta interfaz, el indexador puede notificar a los clientes los cambios en los elementos de sus conjuntos de filas: incluida la adición de nuevos elementos, la eliminación de elementos y la modificación de los datos del elemento.
Herencia
La interfaz IRowsetEvents hereda de la interfaz IUnknown . IRowsetEvents también tiene estos tipos de miembros:
Métodos
La interfaz IRowsetEvents tiene estos métodos.
IRowsetEvents::OnChangedItem Llamado por el indexador para notificar a los clientes que se ha modificado un elemento. Este elemento puede haber coincidedo con algunos (o todos) de los criterios para el conjunto de filas de cliente. |
IRowsetEvents::OnDeletedItem Llamado por el indexador para notificar a los clientes que se ha eliminado un elemento. Este elemento puede haber coincidedo con algunos (o todos) de los criterios de búsqueda del conjunto de filas de cliente. |
IRowsetEvents::OnNewItem Llamado por el indexador para notificar a los clientes un nuevo elemento que puede coincidir con algunos (o todos) de los criterios para el conjunto de filas de cliente. |
IRowsetEvents::OnRowsetEvent Llamado por el indexador para notificar a los clientes un evento relacionado con el conjunto de filas de cliente. |
Comentarios
Cuándo implementar
Implemente IRowsetEvents si el proveedor necesita recibir notificaciones de eventos de conjunto de filas. IRowsetEvents expone métodos para recibir notificaciones de eventos y debe implementarse para recibir las siguientes notificaciones sobre eventos: OnChangedItem, OnDeletedItem, OnNewItem y OnRowsetEvent. Los enumeradores ROWSETEVENT_ITEMSTATE y ROWSETEVENT_TYPE capturan el estado del elemento y el evento de conjunto de filas, respectivamente.El evento de indexador es una nueva característica para Windows 7 que permite a los proveedores recibir notificaciones en sus conjuntos de filas. Los proveedores pueden usar eventos para mantener sus conjuntos de filas de forma que se comporten de forma similar a las ubicaciones reales del sistema de archivos.
La interfaz IRowsetEvents se registra por punto de conexión con un conjunto de filas de indizador abierto.
DBPROP_ENABLEROWSETEVENTS debe establecerse en TRUE con el método ICommandProperties::SetProperties de OLE DB antes de ejecutar la consulta para poder usar eventos de conjunto de filas.
Requisitos
Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
Plataforma de destino | Windows |
Encabezado | searchapi.h |
Consulte también
Conceptual
Indexación de priorización y eventos de conjunto de filas en Windows 7
Proceso de notificaciones (Windows Search)
Referencia