Share via

Método IFilter::GetText (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 Windows Search para la búsqueda del lado cliente y Microsoft Search Server Express para la búsqueda del lado servidor.

Recupera texto (propiedades de tipo texto) del fragmento actual, que debe tener un valor de enumeración CHUNKSTATE de CHUNK_TEXT.

Sintaxis

SCODE GetText(
  [in, out] ULONG *pcwcBuffer,
  [out]     WCHAR *awcBuffer
);

Parámetros

[in, out] pcwcBuffer

En la entrada, el tamaño de la matriz awcBuffer en caracteres anchos o Unicode. Al salir, el número de caracteres Unicode escritos en awcBuffer.

[out] awcBuffer

Texto recuperado del fragmento actual. No finalice el búfer con un carácter. Use una cadena terminada en NULL. La cadena terminada en null no debe superar el tamaño del búfer de destino.

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_TEXT
El miembro flags de la estructura STAT_CHUNK del fragmento actual no tiene un valor de CHUNK_TEXT.
FILTER_E_NO_MORE_TEXT
Se ha devuelto todo el texto del fragmento actual. Las llamadas adicionales al método GetText deben devolver este error hasta que se haya llamado correctamente al método IFilter::GetChunk .
FILTER_S_LAST_TEXT
Como optimización, la última llamada que devuelve texto puede devolver FILTER_S_LAST_TEXT, lo que indica que la siguiente llamada al método GetText devolverá FILTER_E_NO_MORE_TEXT. Esta optimización puede ahorrar tiempo eliminando las llamadas innecesarias a GetText.

Comentarios

Si el fragmento actual es demasiado grande para la matriz awcBuffer , se puede requerir más de una llamada al método GetText para recuperar todo el texto del fragmento actual. Cada llamada al método GetText recupera texto que sigue inmediatamente el texto de la última llamada al método GetText . El último carácter de una llamada puede estar en medio de una palabra y el primer carácter de la siguiente llamada continuaría con esa palabra. Los motores de búsqueda deben controlar esta situación.

Requisitos

Requisito Value
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

CHUNKSTATE

Ifilter