다음을 통해 공유


IFilter 인터페이스(filter.h)

문서에서 텍스트 및 속성(특성이라고도 함)을 검색합니다. 이러한 문서에서 텍스트 청크를 추출하여 포함된 서식을 필터링하고 텍스트 위치에 대한 정보를 유지합니다. 또한 전체 문서 또는 문서의 잘 정의된 부분의 속성인 값 청크를 추출합니다. IFilter 문서 인덱서 및 애플리케이션 독립적 뷰어와 같은 상위 수준 애플리케이션을 빌드하기 위한 기반을 제공합니다.

IFilter 인터페이스가 문서 및 문서 속성에서 작동하는 방법에 대한 소개 정보는 문서 속성참조하세요. IFilter 인터페이스가 문서를 처리하는 방법에 대한 개요 및 예제는 속성 필터링속성 인덱싱참조하세요.

상속

IFilter 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IFilter 다음과 같은 형식의 멤버도 있습니다.

방법

IFilter 인터페이스에는 이러한 메서드가 있습니다.

 
IFilter::BindRegion

개체의 지정된 부분을 나타내는 인터페이스를 검색합니다. 현재 향후 사용을 위해 예약되어 있습니다.
IFilter::GetChunk

GetChunk 메서드에 대한 첫 번째 호출인 경우 필터를 다음 청크의 시작 부분이나 첫 번째 청크에 배치하고 현재 청크에 대한 설명을 반환합니다.
IFilter::GetText

CHUNK_TEXT CHUNKSTATE 열거형 값이 있어야 하는 현재 청크에서 텍스트(텍스트 형식 속성)를 검색합니다.
IFilter::GetValue

청크에서 값(내부 값 형식 속성)을 검색합니다. 청크에는 CHUNK_VALUE CHUNKSTATE 열거형 값이 있어야 합니다.
IFilter::Init

필터링 세션을 초기화합니다.

발언

IFilter 구성 요소는 로컬 보안 컨텍스트에서 실행되며 버퍼를 관리하고 올바르게 스택되도록 작성해야 합니다. 모든 문자열 복사본에는 버퍼 오버런을 방지하려면 명시적 검사가 있어야 합니다. 항상 버퍼의 할당된 크기를 확인하고 버퍼 크기에 대해 데이터 크기를 테스트해야 합니다.

이전에는 IFilter 반환된 데이터는 어휘적으로만 인덱싱되었습니다. Windows 11 버전 26100부터 IFilter 반환된 데이터도 의미 체계적으로 인덱싱됩니다. 예를 들어 "파스타"를 검색하는 사용자는 "lasagna"에 대한 결과를 얻을 수도 있습니다. 또한 Windows 11 버전 26100부터 IPixelFilter 이미지를 의미 체계 인덱싱할 수 있습니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 filter.h

참고 항목

BindIFilterFromStorage

BindIFilterFromStream

LoadIFilter