Interface IFilter (filter.h)

Observação

O Serviço de Indexação não tem mais suporte a partir do Windows XP e não está disponível para uso a partir de Windows 8. Em vez disso, use a Pesquisa do Windows para pesquisa do lado do cliente e o Microsoft Search Server Express para pesquisa no lado do servidor.

Examina documentos em busca de texto e propriedades (também chamados de atributos). Ele extrai partes de texto desses documentos, filtrando a formatação inserida e retendo informações sobre a posição do texto. Ele também extrai partes de valores, que são propriedades de um documento inteiro ou de partes bem definidas de um documento. O IFilter fornece a base para a criação de aplicativos de nível superior, como indexadores de documentos e visualizadores independentes de aplicativos.

Para obter informações introdutórias sobre como a interface IFilter funciona com documentos e propriedades do documento, consulte Propriedades de documentos. Para obter uma sinopse e um exemplo de como a interface IFilter processa um documento, consulte Filtragem de propriedades e indexação de propriedade.

Herança

A interface IFilter herda da interface IUnknown . O IFilter também tem estes tipos de membros:

Métodos

A interface IFilter tem esses métodos.

IFilter::BindRegion Recupera uma interface que representa a parte especificada do objeto . Atualmente reservado para uso futuro.
IFilter::GetChunk Posiciona o filtro no início da próxima parte ou na primeira parte se essa for a primeira chamada para o método GetChunk e retorna uma descrição da parte atual.
IFilter::GetText Recupera texto (propriedades do tipo texto) da parte atual, que deve ter um valor de enumeração CHUNKSTATE de CHUNK_TEXT.
IFilter::GetValue Recupera um valor (propriedade de tipo de valor interno) de uma parte, que deve ter um valor de enumeração CHUNKSTATE de CHUNK_VALUE.
IFilter::Init Inicializa uma sessão de filtragem.

Comentários

Os componentes IFilter para o Serviço de Indexação são executados no contexto de Segurança Local e devem ser gravados para gerenciar buffers e para serem empilhados corretamente. Todas as cópias de cadeia de caracteres devem ter verificações explícitas para proteger contra estouros de buffer. Você sempre deve verificar o tamanho alocado do buffer e testar o tamanho dos dados em relação ao tamanho do buffer.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	filter.h

Confira também

BindIFilterFromStorage

BindIFilterFromStream

LoadIFilter