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 |