ROWSETEVENT_TYPE enumeração (searchapi.h)

Artigo
08/25/2023

Descreve o tipo de alteração nos dados do conjunto de linhas.

Syntax

typedef enum __MIDL___MIDL_itf_searchapi_0000_0023_0002 {
  ROWSETEVENT_TYPE_DATAEXPIRED = 0,
  ROWSETEVENT_TYPE_FOREGROUNDLOST = 1,
  ROWSETEVENT_TYPE_SCOPESTATISTICS = 2
} ROWSETEVENT_TYPE;

Constantes


`ROWSETEVENT_TYPE_DATAEXPIRED` Valor: 0 Indica que os dados que dão suporte ao conjunto de linhas expiraram e que um novo conjunto de linhas deve ser solicitado.
`ROWSETEVENT_TYPE_FOREGROUNDLOST` Valor: 1 Indica que um item que tinha prioridade de primeiro plano na pilha de priorização foi rebaixado, porque outra pessoa se priorizou antes dessa consulta.
`ROWSETEVENT_TYPE_SCOPESTATISTICS` Valor: 2 Indica que as estatísticas de escopo devem ser obtidas.

Comentários

Essa enumeração é usada no método IRowsetEvents::OnRowsetEvent para descrever o tipo de evento que afeta um conjunto de linhas.

O evento ROWSETEVENT_TYPE_SCOPESTATISTICS fornece as mesmas informações disponíveis na chamada do método IRowsetPrioritization::GetScopeStatistics , mas por meio de um mecânico de push, da seguinte maneira:

O evento surgirá se a API de priorização tiver sido usada para solicitar um nível de priorização não padrão e uma frequência de evento de estatísticas diferente de zero.
O evento surge somente quando as estatísticas realmente mudam e o intervalo especificado em IRowsetPrioritization já passou (o intervalo não garante a frequência do evento).
Esse evento é garantido para gerar um estado de "salto zero" (zero itens restantes a serem adicionados, zero modificações restantes), desde que um evento diferente de zero tenha sido gerado.
O indexador poderá processar itens sem enviar esse evento, se a fila esvaziar antes da frequência do evento de estatísticas.

Confira o exemplo de código SearchEvents.

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]
Cabeçalho	searchapi.h