ISearchPersistentItemsChangedSink::StartedMonitoringScope-Methode (searchapi.h)

Artikel
03/06/2024

Wird von einem Benachrichtigungsanbieter aufgerufen, um den Indexer zu benachrichtigen, Änderungen an Elementen innerhalb eines angegebenen hierarchischen Bereichs zu überwachen.

Syntax

HRESULT StartedMonitoringScope(
  [in] LPCWSTR pszURL
);

Parameter

[in] pszURL

Typ: LPCWSTR

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die Startadresse für den zu überwachenden Bereich darstellt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn Benachrichtigungsverluste auftreten, wird ein Benachrichtigungs-Agent online und ruft StartedMonitoringScope auf, sodass eine indexverwaltete Benachrichtigungsquelle sich selbst einer Liste mit "überwachten Bereichen" hinzufügen kann. Der Indexer startet eine inkrementelle Durchforstung des entsprechenden Dokumentspeichers. Der Indexer durchforstet diese Bereiche inkrementell, bis die extremen Bedingungen, die den Verlust von Benachrichtigungen verursacht haben, nicht mehr vorhanden sind. Diese Methode stellt sicher, dass alle Änderungen im Speicher erkannt werden, die während eines Zeitraums mit Benachrichtigungsverlust auftreten.

Unter normalen Umständen wird die Liste der überwachten Bereiche nicht verwendet. Benachrichtigungsverluste sind selten und treten in der Regel nur auf, wenn der Speicherplatz extrem gering ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	searchapi.h
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Freigeben über