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
S_OK	La operación se completó correctamente.
FILTER_E_END_OF_CHUNKS	El fragmento anterior es el último fragmento.
FILTER_E_EMBEDDING_UNAVAILABLE	El siguiente fragmento es una inserción y no hay ningún filtro de contenido disponible.
FILTER_E_LINK_UNAVAILABLE	El siguiente fragmento es un vínculo y no hay ningún filtro de contenido disponible.
FILTER_E_PASSWORD	Error de acceso relacionado con la seguridad u otra contraseña.
FILTER_E_ACCESS	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

Consulte también

Ifilter

STAT_CHUNK