Retornando propriedades de um processador de filtro

As propriedades são extraídas de itens usando manipuladores de propriedade registrados ou usando filtros registrados para tipos de arquivo específicos. Um manipulador de filtro (uma implementação da interface IFilter ) pode interpretar o conteúdo de um tipo de arquivo de várias maneiras.

Este tópico é organizado da seguinte maneira:

Filtragem de propriedades

As práticas recomendadas para filtragem de propriedades estão listadas na tabela a seguir.

Método Description
IFilter::Init Retorna a enumeração IFILTER_FLAGS. Se o membro IFILTER_FLAGS_OLE_PROPERTIES dessa enumeração for definido como um, o Windows Search usará as interfaces IPropertySetStorage e IPropertyStorage para enumerar e acessar propriedades externas do tipo valor.
IFilter::GetChunk Retorna informações de um documento em "partes" com tipo de parte (texto ou valor), nome e localidade. Um bloco contém uma propriedade de documento.
IFilter::GetText Obtém uma propriedade do tipo texto de um bloco.
IFilter::GetValue Obtém uma propriedade do tipo valor de um fragmento.

A ilustração a seguir mostra um documento de exemplo. A propriedade DocTitle de tipo de valor externo (obtida usando métodos das interfaces IPropertySetStorage e IPropertyStorage ) e a propriedade Book de tipo de valor interno (obtida como resultado de uma implementação personalizada do IFilter ) descrevem o documento como um todo. As propriedades Contents do tipo texto e Chapter descrevem o conteúdo do documento. Ao processar este documento, o manipulador de filtro (uma implementação da interface IFilter ) identifica e extrai essas propriedades.

diagrama mostrando os elementos de um documento típico

Limitações de tamanho da propriedade

Há duas possíveis limitações para o tamanho da propriedade:

  • O tamanho máximo dos dados que a Pesquisa do Windows aceita por arquivo.
  • O tamanho máximo por propriedade, conforme definido no arquivo de descrição da propriedade.

Atualmente, o Windows Search não usa o tamanho da propriedade definido ao calcular a quantidade de dados que aceita de um item. Em vez disso, o limite usado pela Pesquisa do Windows é o produto entre o tamanho do arquivo lido do registro e o MaxGrowFactor (tamanho do arquivo N * MaxGrowFactor). O padrão MaxGrowFactor é quatro.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Gathering Manager
            MaxGrowFactor

Consequentemente, se o tipo de arquivo tende a ser pequeno em tamanho total, mas tiver propriedades maiores, o Windows Search poderá não aceitar todos os dados de propriedade que você deseja emitir. No entanto, você pode aumentar o MaxGrowFactor para atender às suas necessidades.

Recursos adicionais

Desenvolvendo manipuladores de filtro

Sobre manipuladores de filtro na Pesquisa do Windows

Práticas recomendadas para criar manipuladores de filtro na Pesquisa do Windows

Manipuladores de Filtro que Vêm com o Windows

Implementando manipuladores de filtro na Pesquisa do Windows

Registrando manipuladores de filtro

Testando manipuladores de filtro