IFilter::Init-Methode (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.
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Die zu filternde Datei wurde zuvor nicht geladen. |
|
Anzahl und Inhalt von Attributen stimmen nicht überein. |
|
Der Zugriff wurde aufgrund von Kennwortschutz oder ähnlichen Sicherheitsmaßnahmen verweigert. |
|
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 |