IFilter::GetChunk-Methode (filter.h)

  • Artikel

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.

Positioniert den Filter am Anfang des nächsten Blocks oder am ersten Block, wenn dies der erste Aufruf der GetChunk-Methode ist, und gibt eine Beschreibung des aktuellen Blockes zurück.

Syntax

SCODE GetChunk(
  [out] STAT_CHUNK *pStat
);

Parameter

[out] pStat

Ein Zeiger auf eine STAT_CHUNK-Struktur , die eine Beschreibung des aktuellen Blöckes enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der Vorgang wurde erfolgreich abgeschlossen.
FILTER_E_END_OF_CHUNKS
 Der vorherige Block ist der letzte Block.
FILTER_E_EMBEDDING_UNAVAILABLE
 Der nächste Block ist eine Einbettung, und es ist kein Inhaltsfilter verfügbar.
FILTER_E_LINK_UNAVAILABLE
 Der nächste Block ist ein Link, und es ist kein Inhaltsfilter verfügbar.
FILTER_E_PASSWORD
 Kennwort- oder anderer sicherheitsbezogener Zugriffsfehler.
FILTER_E_ACCESS
Allgemeiner Zugriffsfehler.

Hinweise

Wenn bei der Rückgabe von pStat auf eine STAT_CHUNK-Struktur mit dem breakType-Member gleich CHUNK_NO_BREAK zeigt, wird nur das element idChunk mit dem neuen Chunk-ID-Wert aktualisiert. Die anderen Member der STAT_CHUNK-Struktur bleiben unverändert.

Interne Werttypeigenschaften (Blöcke mit dem CHUNKSTATE-Enumerationswert CHUNK_VALUE) können nicht mit CHUNK_NO_BREAK verkettet werden. Ein einzelnes Wort darf sich nicht über mehr als zwei geklebte Blöcke erstrecken.

Block-ID 0 ist ungültig.

Bevor die GetChunk-Methode zum ersten Mal aufgerufen wird, gibt es keinen aktuellen Block. Nach einem Fehler, der einen anderen Code als FILTER_E_END_OF_CHUNKS, ruft der nächste Aufruf der GetChunk-Methode trotzdem den nächsten Block nach dem nicht verfügbaren ab.

Hinweise für Anrufer

Wenn die GetChunk-Methode abgeschlossen ist, ist der in *pStat beschriebene Block der aktuelle Block. Der Chunkdeskriptor gehört der Routine, die die GetChunk-Methode aufruft, aber der Eigenschaftennamezeiger, der in der Eigenschaftenspezifikation festgelegt werden kann, gehört der GetChunk-Methode und sollte nicht freigegeben werden.

Hinweise für Implementierer

Wenn ein Aufruf der GetChunk-Methode des Inhaltsfilters eines verknüpften oder eingebetteten Objekts FILTER_E_END_OF_CHUNKS zurückgibt, sollte die Implementierung den nächsten Abschnitt des verknüpfenden oder einbettenden Objekts zurückgeben. Wenn ein Dokument beispielsweise über zwei eingebettete Objekte verfügt und das erste FILTER_E_END_OF_CHUNKS zurückgegeben hat, muss der äußere Inhaltsfilter die GetChunk-Methode des Inhaltsfilters für das eingebettete Objekt aufrufen.

Bevor Sie die Ergebnisse eines Aufrufs der GetChunk-Methode für ein eingebettetes oder verknüpftes Objekt zurückgeben, überprüfen Sie, ob die Block-ID eindeutig ist. Andernfalls muss der Implementierer den Block neu nummerieren und eine Zuordnung der neuen Block-ID beibehalten.

Anforderungen

   
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

Ifilter

STAT_CHUNK