IFilter::GetValue-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.

Ruft einen Wert (interne Werttypeigenschaft) aus einem Block ab, der den CHUNKSTATE-Enumerationswert CHUNK_VALUE aufweisen muss.

Syntax

SCODE GetValue(
  [out] PROPVARIANT **ppPropValue
);

Parameter

[out] ppPropValue

Ein Zeiger auf eine Ausgabevariable, die einen Zeiger auf die PROPVARIANT-Struktur empfängt, die die value-type-Eigenschaft enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der Vorgang wurde erfolgreich abgeschlossen.
FILTER_E_NO_MORE_VALUES
Die GetValue-Methode wurde bereits für diesen Block aufgerufen. Dieser Wert sollte zurückgegeben werden, bis die IFilter::GetChunk-Methode erfolgreich aufgerufen und zum nächsten Block erweitert wurde.
FILTER_E_NO_VALUES
 Der aktuelle Block verfügt nicht über den CHUNKSTATE-Enumerationswert CHUNK_VALUE.

Hinweise

Rufen Sie die GetValue-Methode nur einmal pro Block auf.

Beachten Sie, dass der Effekt, denselben Wert aus mehreren Blöcken zu erzeugen, nicht definiert ist. Nur die letzte Einstellung des Werts ist gültig.

Hinweise für Anrufer

Ordnen Sie die PROPVARIANT-Struktur mit CoTaskMemAlloc zu. Einige PROPVARIANT-Strukturen enthalten Zeiger, die durch Aufrufen der PropVariantClear-Funktion freigegeben werden können. Es liegt beim Aufrufer der GetValue-Methode , PropVariantClear aufzurufen.

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