IFilter::Init-Methode (filter.h)

Artikel
03/01/2024

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.

Initialisiert eine Filtersitzung.

Syntax

SCODE Init(
  [in]  ULONG              grfFlags,
  [in]  ULONG              cAttributes,
  [in]  const FULLPROPSPEC *aAttributes,
  [out] ULONG              *pFlags
);

Parameter

[in] grfFlags

Werte aus der IFILTER_INIT-Enumeration zum Steuern der Textstandardisierung, der Eigenschaftsausgabe, des Einbettungsbereichs und der IFilter-Zugriffsmuster .

[in] cAttributes

Die Größe des Attributarrays. Bei ungleich null hat cAttributes Vorrang vor attributen, die in grfFlags angegeben sind. Wenn keine Attributflags angegeben werden und cAttributes null ist, wird der Standardwert durch den PSGUID_STORAGE Speichereigenschaftssatz angegeben, der Datum und Uhrzeit des letzten Schreibvorgangs in die Datei, größe usw. enthält. und durch die PID_STG_CONTENTS Eigenschaft "contents", die dem Standard Inhalt der Datei zugeordnet ist. Weitere Informationen zu Eigenschaften und Eigenschaftensätzen finden Sie unter Eigenschaftensätze.

[in] aAttributes

Zeiger auf ein Array von FULLPROPSPEC-Strukturen für die angeforderten Eigenschaften. Wenn cAttributes ungleich null ist, werden nur die Eigenschaften in aAttributes zurückgegeben.

[out] pFlags

Informationen zu zusätzlichen Eigenschaften, die dem Aufrufer zur Verfügung stehen; aus der IFILTER_FLAGS-Enumeration .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich abgeschlossen.
E_FAIL	Die zu filternde Datei wurde zuvor nicht geladen.
E_INVALIDARG	Anzahl und Inhalt von Attributen stimmen nicht überein.
FILTER_E_PASSWORD	Der Zugriff wurde aufgrund von Kennwortschutz oder ähnlichen Sicherheitsmaßnahmen verweigert.
FILTER_E_ACCESS	Allgemeine Zugriffsfehler

Hinweise

Die Init-Methode legt den Status des Filterobjekts fest. Der Inhaltsfilter positioniert sich am Anfang des Objekts, und der Objektzustand wird eingefroren, bis das Objekt freigegeben wird. Sie können dem Filterobjekt den Satz von Eigenschaften übergeben, den Sie zurückgeben möchten, indem Sie deren Eigenschaftensatz- und ID-Beschreibungen (Property Identifier) im aAttributes-Array einrichten. Weitere Informationen finden Sie unter Filtern von Dateieigenschaften.

Hinweise für Anrufer

Rufen Sie die Init-Methode auf, bevor Sie alle anderen IFilter-Methoden aufrufen.

Hinweise für Implementierer

Block-IDs müssen über mehrere Aufrufe der Init-Methode mit den gleichen Parametern hinweg konsistent bleiben.

Bei einigen Implementierungen der IFilter-Schnittstelle ist die Erkennung eines Fehlers beim Zugriff auf ein Dokument möglicherweise erst möglich (oder rechenintensiv), wenn die Init-Methode aufgerufen wurde oder möglicherweise sogar später.

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