IFilter-Schnittstelle (filter.h)

Hinweis

Der Indizierungsdienst wird ab Windows XP nicht mehr unterstützt und steht ab Windows 8 nicht mehr zur Verfügung. Verwenden Sie stattdessen Windows Search für die clientseitige Suche und Microsoft Search Server Express für die serverseitige Suche.

Überprüft Dokumente auf Text und Eigenschaften (auch Attribute genannt). Es extrahiert Textblöcke aus diesen Dokumenten, filtert eingebettete Formatierungen heraus und speichert Informationen über die Position des Texts. Außerdem werden Werteblöcke extrahiert, bei denen es sich um Eigenschaften eines gesamten Dokuments oder von wohldefinierten Teilen eines Dokuments handelt. IFilter bietet die Grundlage für die Erstellung von Anwendungen auf höherer Ebene, z. B. Dokumentindexer und anwendungsunabhängige Viewer.

Einführungsinformationen zur Funktionsweise der IFilter-Schnittstelle mit Dokumenten und Dokumenteigenschaften finden Sie unter Eigenschaften von Dokumenten. Eine Zusammenfassung und ein Beispiel für die Verarbeitung eines Dokuments durch die IFilter-Schnittstelle finden Sie unter Eigenschaftenfilterung und Eigenschaftenindizierung.

Vererbung

Die IFilter-Schnittstelle erbt von der IUnknown-Schnittstelle . IFilter verfügt auch über folgende Arten von Membern:

Methoden

Die IFilter-Schnittstelle verfügt über diese Methoden.

IFilter::BindRegion Ruft eine Schnittstelle ab, die den angegebenen Teil des Objekts darstellt. Derzeit für die zukünftige Verwendung reserviert.
IFilter::GetChunk Positioniert den Filter am Anfang des nächsten Blöckes oder am ersten Block, wenn dies der erste Aufruf der GetChunk-Methode ist, und gibt eine Beschreibung des aktuellen Blöckes zurück.
IFilter::GetText Ruft Text (Texttypeigenschaften) aus dem aktuellen Block ab, der den CHUNKSTATE-Enumerationswert CHUNK_TEXT aufweisen muss.
IFilter::GetValue Ruft einen Wert (interne Werttypeigenschaft) aus einem Block ab, der den CHUNKSTATE-Enumerationswert CHUNK_VALUE aufweisen muss.
IFilter::Init Initialisiert eine Filtersitzung.

Hinweise

IFilter-Komponenten für den Indizierungsdienst werden im Lokalen Sicherheitskontext ausgeführt und sollten geschrieben werden, um Puffer zu verwalten und ordnungsgemäß zu stapeln. Alle Zeichenfolgenkopien müssen explizite Überprüfungen aufweisen, um Pufferüberläufe zu verhindern. Sie sollten immer die zugeordnete Größe des Puffers überprüfen und die Größe der Daten anhand der Größe des Puffers testen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	filter.h

Weitere Informationen

BindIFilterFromStorage

BindIFilterFromStream

LoadIFilter