Méthode ISearchNotifyInlineSite ::OnCatalogStatusChange (searchapi.h)

Appelé par le service de recherche pour notifier un client lorsque le status du catalogue change.

Syntaxe

HRESULT OnCatalogStatusChange(
  [in] REFGUID guidCatalogResetSignature,
  [in] REFGUID guidCheckPointSignature,
  [in] DWORD   dwLastCheckPointNumber
);

Paramètres

[in] guidCatalogResetSignature

Type : REFGUID

GUID représentant la réinitialisation du catalogue. Si ce GUID change, toutes les notifications doivent être envoyées de nouveau.

[in] guidCheckPointSignature

Type : REFGUID

GUID représentant le dernier point de contrôle restauré. Si ce GUID change, toutes les notifications accumulées depuis le dernier point de contrôle enregistré doivent être envoyées de nouveau.

[in] dwLastCheckPointNumber

Type : DWORD

Nombre indiquant le dernier point de contrôle enregistré.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Lorsqu’un point de contrôle de catalogue se produit, le service de recherche met à jour dwLastCheckPointNumber, et toutes les notifications envoyées avant ce point de contrôle sont sécurisées et récupérables en cas de défaillance du service. Les fournisseurs de notifications doivent suivre uniquement les notifications envoyées entre les points de contrôle et doivent les renvoyer si le catalogue est restauré ou réinitialisé.

Si une restauration de catalogue se produit, le service de recherche restaure le catalogue au dernier point de contrôle enregistré et met à jour guidCheckPointSignature. Dans ce cas, les fournisseurs de notifications doivent renvoyer toutes les notifications accumulées depuis le point de contrôle enregistré le plus récent, comme identifié par le paramètre dwLastCheckPointNumber .

Si une réinitialisation de catalogue se produit, le service de recherche réinitialise l’ensemble du catalogue et met à jour guidCatalogResetSignature. Le fournisseur de notifications doit renvoyer l’ensemble de son étendue d’analyse.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	searchapi.h
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Voir aussi

ISearchNotifyInlineSite

Notification de l’index des modifications