Share via

Método IFilter::GetValue (filter.h)

  • Artículo

Nota:

El servicio de indexación ya no se admite a partir de Windows XP y no está disponible para su uso a partir de Windows 8. En su lugar, use La búsqueda del lado cliente de Windows Search y Microsoft Search Server Express para la búsqueda del lado servidor.

Recupera un valor (propiedad de tipo valor interno) de un fragmento, que debe tener un valor de enumeración CHUNKSTATE de CHUNK_VALUE.

Sintaxis

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

Parámetros

[out] ppPropValue

Puntero a una variable de salida que recibe un puntero a la estructura PROPVARIANT que contiene la propiedad value-type.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 La operación se completó correctamente.
FILTER_E_NO_MORE_VALUES
Ya se ha llamado al método GetValue en este fragmento; Este valor debe devolverse hasta que se haya llamado correctamente al método IFilter::GetChunk y haya avanzado al siguiente fragmento.
FILTER_E_NO_VALUES
 El fragmento actual no tiene un valor de enumeración CHUNKSTATE de CHUNK_VALUE.

Comentarios

Llame al método GetValue solo una vez por fragmento.

Tenga en cuenta que el efecto de producir el mismo valor a partir de más de un fragmento no está definido. Solo el último valor del valor es válido.

Notas a los autores de llamadas

Asigne la estructura PROPVARIANT con CoTaskMemAlloc. Algunas estructuras PROPVARIANT contienen punteros, que se pueden liberar llamando a la función PropVariantClear . Depende del autor de la llamada del método GetValue llamar a PropVariantClear.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado filter.h

Consulte también

Ifilter