Интерфейс IFilter (filter.h)
Примечание
Служба индексирования больше не поддерживается в Windows XP и недоступна для использования с Windows 8. Вместо этого используйте Windows Search для поиска на стороне клиента и Microsoft Search Server Express для поиска на стороне сервера.
Проверяет документы на наличие текста и свойств (также называемых атрибутами). Он извлекает фрагменты текста из этих документов, отфильтровывает внедренное форматирование и сохраняет сведения о расположении текста. Он также извлекает фрагменты значений, которые являются свойствами всего документа или четко определенных частей документа. IFilter предоставляет основу для создания приложений более высокого уровня, таких как индексаторы документов и средства просмотра, независимые от приложений.
Вводные сведения о том, как интерфейс IFilter работает с документами и свойствами документа, см. в разделе Свойства документов. Краткое описание и пример того, как интерфейс IFilter обрабатывает документ, см. в разделе Фильтрация свойств и индексирование свойств.
Наследование
Интерфейс IFilter наследуется от интерфейса IUnknown . IFilter также имеет следующие типы членов:
Методы
Интерфейс IFilter содержит следующие методы.
| IFilter::BindRegion Извлекает интерфейс, представляющий указанную часть объекта . В настоящее время зарезервировано для использования в будущем. |
| IFilter::GetChunk Помещает фильтр в начало следующего блока или в первый блок, если это первый вызов метода GetChunk, и возвращает описание текущего блока. |
| IFilter::GetText Извлекает текст (свойства текстового типа) из текущего фрагмента, который должен иметь значение перечисления CHUNKSTATE, равное CHUNK_TEXT. |
| IFilter::GetValue Извлекает значение (внутреннее свойство типа значения) из блока, который должен иметь значение перечисления CHUNKSTATE, равное CHUNK_VALUE. |
| IFilter::Init Инициализирует сеанс фильтрации. |
Комментарии
Компоненты IFilter для службы индексирования выполняются в контексте локальной безопасности и должны быть записаны для управления буферами и правильного стека. Все копии строк должны иметь явные проверки для защиты от переполнения буфера. Всегда следует проверять выделенный размер буфера и проверять размер данных на соответствие размеру буфера.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | filter.h |