ILoadFilter::LoadIFilter 메서드(filtereg.h)

셸 데이터 원본에 매핑되는 가장 적절한 필터를 검색하고 로드합니다.

구문

HRESULT LoadIFilter(
  [in]      LPCWSTR               pwcsPath,
  [in]      FILTERED_DATA_SOURCES *pFilteredSources,
  [in]      IUnknown              *pUnkOuter,
  [in]      BOOL                  fUseDefault,
  [in, out] CLSID                 *pFilterClsid,
  [in, out] int                   *SearchDecSize,
  [in, out] WCHAR                 **pwcsSearchDesc,
  [in, out] IFilter               **ppIFilt
);

매개 변수

[in] pwcsPath

필터링할 파일의 경로를 지정하는 쉼표로 구분된 null로 끝나는 유니코드 문자열 버퍼에 대한 포인터입니다. 이 매개 변수는 null일 수 있습니다.

[in] pFilteredSources

필터가 로드되는 Shell 데이터 원본에 대한 매개 변수를 지정하는 FILTERED_DATA_SOURCES 구조체에 대한 포인터입니다. 이 매개 변수는 null일 수 없습니다.

[in] pUnkOuter

개체가 집계의 일부로 만들어지는 경우 집계의 제어 IUnknown 인터페이스에 대한 포인터를 지정합니다.

[in] fUseDefault

TRUE이면 기본 필터를 사용합니다. FALSE이면 사용 가능한 가장 적절한 필터를 계속 진행합니다.

[in, out] pFilterClsid

반환된 필터의 클래스 식별자를 수신하는 CLSID(CLSID_FilterRegistration)에 대한 포인터입니다.

[in, out] SearchDecSize

구현되지 않았습니다.

[in, out] pwcsSearchDesc

구현되지 않았습니다.

[in, out] ppIFilt

LoadIFilter가 선택하는 IFilter 인터페이스 구현에 대한 포인터의 주소입니다.

반환 값

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

설명

필터 처리기라고도 하는 필터는 IFilter 인터페이스의 구현입니다.

ILoadFilter는 pwcsPath 매개 변수를 통해 pFilteredSources 매개 변수에 지정된 형식의 셸 데이터 원본을 처리할 수 있는 필터를 로드하려고 합니다. 데이터 원본에 대한 적절한 필터를 찾을 수 없으며 fUseDefault가 false이면 이 메서드는 ppIFilt 매개 변수에서 null을 반환합니다. 데이터 원본에 대한 적절한 필터를 찾을 수 없으며 fUseDefault가 true이면 기본 IFilter의 IFilter 인터페이스가 ppIFilt 매개 변수에 반환됩니다.

요구 사항

추가 정보

ILoadFilter