IFilter::GetChunk-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.
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der vorherige Block ist der letzte Block. |
|
Der nächste Block ist eine Einbettung, und es ist kein Inhaltsfilter verfügbar. |
|
Der nächste Block ist ein Link, und es ist kein Inhaltsfilter verfügbar. |
|
Kennwort- oder anderer sicherheitsbezogener Zugriffsfehler. |
|
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 |