Método IFilter::GetChunk (filter.h)
Nota
El servicio de indexación ya no se admite a partir de Windows XP y no está disponible para su uso desde 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.
Coloca el filtro al principio del fragmento siguiente o en el primer fragmento si se trata de la primera llamada al método GetChunk y devuelve una descripción del fragmento actual.
Sintaxis
SCODE GetChunk(
[out] STAT_CHUNK *pStat
);
Parámetros
[out] pStat
Puntero a una estructura de STAT_CHUNK que contiene una descripción del fragmento actual.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
La operación se completó correctamente. |
|
El fragmento anterior es el último fragmento. |
|
El siguiente fragmento es una inserción y no hay ningún filtro de contenido disponible. |
|
El siguiente fragmento es un vínculo y no hay ningún filtro de contenido disponible. |
|
Error de acceso relacionado con la seguridad u otra contraseña. |
|
Error de acceso general. |
Comentarios
Si al devolver pStat apunta a una estructura de STAT_CHUNK con el miembro breakType igual a CHUNK_NO_BREAK, solo el miembro idChunk se actualizará con el nuevo valor de identificador de fragmento (ID). Los demás miembros de la estructura STAT_CHUNK permanecen sin cambios.
Las propiedades internas de tipo de valor (fragmentos con un valor de enumeración CHUNKSTATE de CHUNK_VALUE) no se pueden concatenar mediante CHUNK_NO_BREAK. Una sola palabra no puede abarcar más de dos fragmentos pegados.
El identificador de fragmento cero no es válido.
Antes de llamar al método GetChunk por primera vez, no hay ningún fragmento actual. Después de un error, se devuelve el código de cualquier cosa que no sea FILTER_E_END_OF_CHUNKS la siguiente llamada al método GetChunk , pero recupera el siguiente fragmento después del no disponible.
Notas a los autores de llamadas
Cuando finaliza el método GetChunk , el fragmento descrito en *pStat es el fragmento actual. El descriptor de fragmento es propiedad de la rutina que llama al método GetChunk , pero el puntero de nombre de propiedad, que se puede establecer en la especificación de propiedad, es propiedad del método GetChunk y no debe liberarse.Notas para los implementadores
Si una llamada al método GetChunk del filtro de contenido de un objeto vinculado o incrustado devuelve FILTER_E_END_OF_CHUNKS, la implementación debe devolver el siguiente fragmento del objeto de vinculación o inserción. Por ejemplo, si un documento tiene dos objetos incrustados y el primero ha devuelto FILTER_E_END_OF_CHUNKS, el filtro de contenido externo debe llamar al método GetChunk del filtro de contenido para el objeto incrustado.Antes de devolver los resultados de una llamada al método GetChunk en un objeto incrustado o vinculado, compruebe que el identificador del fragmento es único. Si no es así, el implementador debe volver a numerar el fragmento y mantener una asignación del nuevo identificador de fragmento.
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 |