IProtocolHandlerSite::GetFilter 메서드(searchapi.h)

제공된 매개 변수에 따라 적절한 IFilter 를 검색합니다.

구문

HRESULT GetFilter(
  [in]  CLSID   *pclsidObj,
  [in]  LPCWSTR pcwszContentType,
  [in]  LPCWSTR pcwszExtension,
  [out] IFilter **ppFilter
);

매개 변수

[in] pclsidObj

형식: CLSID*

레지스트리에서 문서 형식의 CLSID에 대한 포인터입니다. 포함된 문서에 사용할 적절한 IFilter 를 나타내기 위해 포함된 문서가 있는 항목에 사용됩니다.

[in] pcwszContentType

형식: LPCWSTR

문서 형식을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. MIME 형식에 따라 매핑되는 IFilter를 검색하는 데 사용됩니다.

[in] pcwszExtension

형식: LPCWSTR

이전 기간 없이 파일 이름 확장명을 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다. 파일 이름 확장명 에 따라 매핑되는 IFilter 개체를 검색하는 데 사용됩니다.

[out] ppFilter

형식: IFilter**

프로토콜 처리기에서 사용하는 IFilter 에 대한 포인터의 주소를 받습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 필터 호스트를 쿼리하여 URL 항목에 사용할 적절한 IFilter 개체를 식별합니다.

필터의 선택은 파일 이름 확장명, 레지스트리 또는 MIME 콘텐츠 형식에서 파일의 콘텐츠 형식을 식별하는 CLSID를 기반으로 합니다. 이 메서드에 세 가지 매개 변수 중 하나만 제공해야 합니다. 여러 매개 변수를 제공하는 경우 pcwszContentType, pclsidObj, pcwszExtension 순서로 테스트됩니다. 첫 번째 유효한 매개 변수는 적절한 IFilter를 선택하는 데 사용됩니다. 다른 항목은 무시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	WINDOWS Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	searchapi.h
재배포 가능 파일	WDS(Windows 데스크톱 검색) 3.0