Benachrichtigen des Indexes der Änderungen (Ältere Windows-Umgebungsfeatures)

  • Artikel

Hinweis

Windows Desktop Search 2.x ist eine veraltete Technologie, die ursprünglich als Add-In für Windows XP und Windows Server 2003 verfügbar war. Verwenden Sie in späteren Versionen stattdessen Windows Search .

Mit Microsoft Windows Desktop Search (WDS) 2.6 können Protokollhandler für einen bestimmten Datenspeicher dem WDS-Indexer mitteilen, wenn sich Die Daten in ihrem Speicher geändert haben. Dadurch wird die Leistung verbessert, indem sichergestellt wird, dass der Indexer nicht den gesamten Speicher auf inkrementellen Indizes durchforstet. Mithilfe von Benachrichtigungs-APIs können Protokollhandler den Indexer benachrichtigen, dass ein Element verschoben oder gelöscht wurde, und sie können der Durchforstungswarteschlange von URLs, die eine Indizierung erfordern, Bereiche hinzufügen. Benachrichtigungen sind hilfreich für Anwendungen wie E-Mail, bei denen der Protokollhandler den Speicher überwacht und den Indexer benachrichtigt, dass Elemente geändert wurden und eine Indizierung erforderlich ist.

ISearchItemsChangedSink

Protokollhandler benachrichtigen den Indexer über die ISearchItemsChangedSink-Schnittstelle über Änderungen. Informationen zu Datenänderungen sollten in SEARCH_ITEM_CHANGE Strukturen und SEARCH_KIND_OF_CHANGE Enumerationstypen gesammelt und dann über die OnItemsChanged-Methode der ISearchItemsChangedSink-Schnittstelle an den Indexer übermittelt werden.

Um auf diese Schnittstelle zuzugreifen, muss ein benutzerdefinierter Protokollhandler zunächst ein ISearchManager-Objekt instanziieren, um Zugriff auf das ISearchCatalogManager-Objekt zu erhalten. Von dort aus kann man ein ISearchItemsChangedSink-Objekt instanziieren und den Indexer über die Datenänderungen benachrichtigen.

Mit der OnItemsChanged-Methode können Sie Datenänderungen sammeln und an Ihren Kundendatenspeicher übermitteln, um die Indizierung zu initiieren.

Direction Variable Beschreibung
In dwNumberofChanges Gesamtzahl der Änderungen in der Benachrichtigung.
In DataChangeEntries[] Alle Änderungsbenachrichtigungen in einem Array von SEARCH_ITEM_CHANGE Strukturen.
aus dwBatchId Die Batch-ID, die mit Fehlern zurückgegeben wird.
aus hrCompletionCodes[] Gibt an, ob jede URL für die Indizierung akzeptiert wurde.

 

Die SEARCH_ITEM_CHANGE-Struktur identifiziert die Art der Änderung, die aufgetreten ist, sowie die aktuelle URL und die vorherige URL des Elements, falls zutreffend. Die -Struktur ist wie folgt definiert:

Eigenschaftenname Eigenschaftstyp Beschreibung
Change SEARCH_KIND_OF_CHANGE Der Typ der Änderung, die benachrichtigt wird.
URL LPWSTR Die URL für das geänderte Objekt.
OldURL LPWSTR Wenn es sich bei der Benachrichtigung um eine Verschiebung handelt, wird die alte URL angegeben und muss eindeutig sein.
Priority SEARCH_NOTIFICATION_PRIORITY Die Priorität der Änderung.

 

Die SEARCH_KIND_OF_CHANGE-Enumeration ist wie folgt definiert:

Enumerationswert Wert Beschreibung
SEARCH_CHANGE_ADD 0 Die Benachrichtigung gilt für eine zusätzliche URL.
SEARCH_CHANGE_DELETE 1 Die Benachrichtigung gilt für das Löschen einer URL.
SEARCH_CHANGE_MODIFY 2 Die Benachrichtigung lautet, dass eine URL geändert wurde.
SEARCH_CHANGE_MOVE_RENAME 3 Die Benachrichtigung gilt für das Verschieben und Umbenennen eines Objekts in eine neue URL.
SEARCH_CHANGE_SEMANTICS_DIRECTORY 0x10000 Die Benachrichtigung gilt für eine Container-URL.
SEARCH_CHANGE_SEMANTICS_SHALLOW 0x20000 Die Benachrichtigung gilt für eine Container-URL, deren Containereigenschaften nur indiziert werden sollen.
SEARCH_CHANGE_SEMANTICS_SECURITY 0x40000 Die Benachrichtigung gilt für eine URL oder Container-URL, deren Sicherheitseigenschaften geändert wurden.

 

Die SEARCH_NOTIFICATION_PRIORITY-Enumeration ist wie folgt definiert:

Enumerationswert Wert Beschreibung
SEARCH_NORMAL_PRIORITY 0 Beim Indizieren der URL sollte nur eine normale Priorität verwendet werden. Diese Benachrichtigungen werden vor der normalen inkrementellen Indizierung im Hintergrund der Dateien und Speicher eines Benutzers verarbeitet.