enumerazione ROWSETEVENT_TYPE (searchapi.h)

Articolo
08/25/2023

Descrive il tipo di modifica ai dati del set di righe.

Sintassi

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

Costanti


`ROWSETEVENT_TYPE_DATAEXPIRED` Valore: 0 Indica che il backup dei dati del set di righe è scaduto e che deve essere richiesto un nuovo set di righe.
`ROWSETEVENT_TYPE_FOREGROUNDLOST` Valore: 1 Indica che un elemento con priorità in primo piano nello stack di priorità è stato abbassato di livello, perché un altro utente ha priorità prima di questa query.
`ROWSETEVENT_TYPE_SCOPESTATISTICS` Valore: 2 Indica che devono essere ottenute le statistiche di ambito.

Commenti

Questa enumerazione viene utilizzata nel metodo IRowsetEvents::OnRowsetEvent per descrivere il tipo di evento che influisce su un set di righe.

L'evento ROWSETEVENT_TYPE_SCOPESTATISTICS fornisce le stesse informazioni disponibili dalla chiamata al metodo IRowsetPrioritization::GetScopeStatistics, ma tramite un meccanico push, come indicato di seguito:

L'evento si verifica se l'API di definizione delle priorità è stata usata per richiedere un livello di priorità non predefinito e una frequenza di evento delle statistiche non zero.
L'evento si verifica solo quando le statistiche cambiano effettivamente e l'intervallo specificato in IRowsetPrioritization è trascorso (l'intervallo non garantisce la frequenza dell'evento).
Questo evento è garantito per generare uno stato di "rimbalzo zero" (zero elementi rimanenti da aggiungere, zero modifiche rimanenti), purché sia stato generato un evento diverso da zero.
L'indicizzatore può elaborare gli elementi senza inviare questo evento, se la coda svuota prima della frequenza degli eventi delle statistiche.

Vedere l'esempio di codice SearchEvents.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	searchapi.h