IFilter::GetValue-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.
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
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. |
|
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 |