énumération ROWSETEVENT_TYPE (searchapi.h)

Article
08/25/2023

Décrit le type de modification apportée aux données de l’ensemble de lignes.

Syntaxe

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` Valeur : 0 Indique que les données de l’ensemble de lignes ont expiré et qu’un nouvel ensemble de lignes doit être demandé.
`ROWSETEVENT_TYPE_FOREGROUNDLOST` Valeur : 1 Indique qu’un élément qui avait une priorité de premier plan dans la pile de hiérarchisation a été rétrogradé, car une autre personne s’est hiérarchisée avant cette requête.
`ROWSETEVENT_TYPE_SCOPESTATISTICS` Valeur : 2 Indique que les statistiques d’étendue doivent être obtenues.

Notes

Cette énumération est utilisée dans la méthode IRowsetEvents::OnRowsetEvent pour décrire le type d’événement qui affecte un ensemble de lignes.

L’événement ROWSETEVENT_TYPE_SCOPESTATISTICS vous donne les mêmes informations disponibles à partir de l’appel de méthode IRowsetPrioritization::GetScopeStatistics, mais via un mécanicien push, comme suit :

L’événement se produit si l’API de hiérarchisation a été utilisée pour demander un niveau de priorité autre que celui par défaut et une fréquence d’événement de statistiques non nulle.
L’événement se produit uniquement lorsque les statistiques changent réellement et que l’intervalle spécifié dans iRowsetPrioritization s’est écoulé (l’intervalle ne garantit pas la fréquence de l’événement).
Cet événement est garanti pour déclencher un état « zéro rebond » (zéro élément restant à ajouter, zéro modification restante), à condition qu’un événement autre que zéro ait été déclenché.
L’indexeur peut traiter des éléments sans envoyer cet événement, si la file d’attente se vide avant la fréquence de l’événement de statistiques.

Consultez l’exemple de code SearchEvents.

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	searchapi.h