Método IFilter::GetText (filter.h)
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.
SCODE GetText(
[in, out] ULONG *pcwcBuffer,
[out] WCHAR *awcBuffer
);
[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.
Este método puede devolver uno de estos valores.
Código devuelto | Descripción |
---|---|
|
La operación se completó correctamente. |
|
El miembro flags de la estructura STAT_CHUNK del fragmento actual no tiene un valor de CHUNK_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 . |
|
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. |
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.
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 |