Interface IRowsetEvents (searchapi.h)

Artigo
03/15/2023

Expõe métodos para receber notificações de eventos. Quando os clientes implementam essa interface, o indexador pode notificar os clientes sobre alterações em itens em seus conjuntos de linhas: incluindo a adição de novos itens, a exclusão de itens e a modificação nos dados do item.

Herança

A interface IRowsetEvents herda da interface IUnknown . IRowsetEvents também tem estes tipos de membros:

Métodos

A interface IRowsetEvents tem esses métodos.


IRowsetEvents::OnChangedItem Chamado pelo indexador para notificar os clientes de que um item foi modificado. Este item pode ter correspondido a alguns (ou todos) dos critérios do conjunto de linhas do cliente.
IRowsetEvents::OnDeletedItem Chamado pelo indexador para notificar os clientes de que um item foi excluído. Esse item pode ter correspondido a alguns (ou todos) critérios de pesquisa para o conjunto de linhas do cliente.
IRowsetEvents::OnNewItem Chamado pelo indexador para notificar os clientes de um novo item que pode corresponder a alguns (ou todos) dos critérios do conjunto de linhas do cliente.
IRowsetEvents::OnRowsetEvent Chamado pelo indexador para notificar os clientes de um evento relacionado ao conjunto de linhas do cliente.

Comentários

Quando implementar

Implemente IRowsetEvents se o provedor precisar receber notificações de eventos de conjunto de linhas. IRowsetEvents expõe métodos para receber notificações de eventos e deve ser implementado para receber as seguintes notificações sobre eventos: OnChangedItem, OnDeletedItem, OnNewItem e OnRowsetEvent. Os enumeradores ROWSETEVENT_ITEMSTATE e ROWSETEVENT_TYPE capturam o estado do item e o evento do conjunto de linhas, respectivamente.

O evento do indexador é um novo recurso para o Windows 7 que permite que os provedores recebam notificações em seus conjuntos de linhas. Os provedores podem usar o evento para manter seus conjuntos de linhas de forma que se comportem de forma semelhante aos locais reais do sistema de arquivos.

A interface IRowsetEvents é registrada pelo ponto de conexão com um conjunto de linhas do indexador aberto.

DBPROP_ENABLEROWSETEVENTS deve ser definido como TRUE com o método OLE DB ICommandProperties::SetProperties antes de executar a consulta para usar o evento de conjunto de linhas.

Requisitos


Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	searchapi.h