ISearchPersistentItemsChangedSink ::StartedMonitoringScope, méthode (searchapi.h)

Appelé par un fournisseur de notifications pour avertir l’indexeur de surveiller les modifications apportées aux éléments dans une étendue hiérarchique spécifiée.

Syntaxe

HRESULT StartedMonitoringScope(
  [in] LPCWSTR pszURL
);

Paramètres

[in] pszURL

Type : LPCWSTR

Pointeur vers une chaîne Unicode terminée par null qui est l’adresse de début de l’étendue à surveiller.

Valeur retournée

Type : HRESULT

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

Remarques

En cas de perte de notification, un agent de notification est mis en ligne et appelle StartedMonitoringScope, ce qui permet à une source de notification gérée par index de s’ajouter à une liste de « étendues surveillées ». L’indexeur démarre une analyse incrémentielle du magasin de documents correspondant. L’indexeur analyse ces étendues de manière incrémentielle jusqu’à ce que les conditions extrêmes qui ont provoqué la perte de notifications ne soient plus présentes. Cette méthode garantit que toutes les modifications apportées au magasin qui se produisent pendant une période de perte de notification sont détectées.

En temps normal, la liste des étendues surveillées n’est pas utilisée. La perte de notification est rare et se produit généralement uniquement lorsque l’espace disque est extrêmement faible.

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