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 |