Interface IRowsetEvents (searchapi.h)
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 |
Confira também
Conceitual
Indexando eventos de priorização e conjunto de linhas no Windows 7
Processo de notificações (Pesquisa do Windows)
Referência