Devolver propiedades de un controlador de filtros

Artículo
06/13/2023

Las propiedades se extraen de elementos mediante controladores de propiedades registrados o mediante filtros registrados para tipos de archivo específicos. Un controlador de filtro (una implementación de la interfaz IFilter ) puede interpretar el contenido de un tipo de archivo de cualquier manera.

Este tema se organiza de la siguiente manera:

Filtrado de propiedades
- Limitaciones de tamaño de propiedad
Recursos adicionales
Temas relacionados

Filtrado de propiedades

Los procedimientos recomendados para el filtrado de propiedades se enumeran en la tabla siguiente.

Método	Descripción
IFilter::Init	Devuelve la enumeración IFILTER_FLAGS . Si el miembro IFILTER_FLAGS_OLE_PROPERTIES de esta enumeración se establece en uno, Windows Search usa las interfaces IPropertySetStorage e IPropertyStorage para enumerar y obtener acceso a las propiedades de tipo de valor externo.
IFilter::GetChunk	Devuelve información de un documento en "fragmentos" con tipo de fragmento (texto o valor), nombre y configuración regional. Un fragmento contiene una propiedad de documento.
IFilter::GetText	Obtiene una propiedad de tipo de texto de un fragmento.
IFilter::GetValue	Obtiene una propiedad de tipo de valor de un fragmento.

En la ilustración siguiente se muestra un documento de ejemplo. La propiedad DocTitle de tipo de valor externo (obtenida mediante métodos de las interfaces IPropertySetStorage e IPropertyStorage ) y la propiedad Book de tipo de valor interno (obtenida como resultado de una implementación de IFilter personalizada) describe el documento en su conjunto. Las propiedades Contents de tipo de texto y Chapter describen el contenido del documento. Al procesar este documento, el controlador de filtro (una implementación de la interfaz IFilter ) identifica y extrae estas propiedades.

diagrama que muestra los elementos de un documento típico

Limitaciones de tamaño de propiedad

Hay dos limitaciones potenciales para el tamaño de propiedad:

Tamaño máximo de datos que Windows Search acepta por archivo.
Tamaño máximo por propiedad tal y como se define en el archivo de descripción de la propiedad.

Actualmente, Windows Search no usa el tamaño de propiedad definido al calcular la cantidad de datos que acepta de un elemento. En su lugar, el límite que usa Windows Search es el producto del tamaño del archivo y el MaxGrowFactor (tamaño de archivo N * MaxGrowFactor) leído del registro. El valor predeterminado MaxGrowFactor es cuatro.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Gathering Manager
            MaxGrowFactor

Por lo tanto, si el tipo de archivo tiende a ser pequeño en tamaño total, pero tiene propiedades más grandes, Windows Search puede no aceptar todos los datos de propiedad que desea emitir. Sin embargo, puede aumentar para MaxGrowFactor satisfacer sus necesidades.

Recursos adicionales

El ejemplo de código IFilterSample , disponible en GitHub, muestra cómo crear una clase base IFilter para implementar la interfaz IFilter .
Para obtener información general sobre el proceso de indexación, consulte El proceso de indexación.
Para obtener información general sobre los tipos de archivo, consulte Tipos de archivo.
Para consultar los atributos de asociación de archivos de un tipo de archivo, vea PerceivedTypes, SystemFileAssociations y Application Registration.
Para obtener información general sobre las propiedades y los controladores de propiedades, y una lista de propiedades del sistema que puedes usar para los formatos de archivo, consulta Developing Property Handlers for Windows Search.