ISearchPersistentItemsChangedSink::StartedMonitoringScope-Methode (searchapi.h)

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