IFolderFilterSite::SetFilter 메서드(shobjidl_core.h)

클라이언트가 호스트에 IUnknown 인터페이스 포인터를 전달할 수 있도록 호스트에 의해 노출됩니다.

구문

HRESULT SetFilter(
  [in] IUnknown *punk
);

매개 변수

[in] punk

형식: IUnknown*

클라이언트의 IUnknown 인터페이스에 대한 포인터입니다. 호스트에 필터링을 종료하고 IFolderFilter 인터페이스 호출을 중지하도록 알리려면 이 매개 변수를 NULL로 설정합니다.

반환 값

형식: HRESULT

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

설명

호스트의 IFolderFilterSite 인터페이스에 대한 포인터를 받은 후 이 메서드를 호출하여 호스트에 IUnknown 인터페이스에 대한 포인터를 전달합니다. 그런 다음 호스트는 이 포인터를 사용하여 QueryInterface 메서드를 호출하여 IFolderFilter 인터페이스에 대한 포인터를 요청합니다. 이 호출이 실패하면 IFolderFilterSite::SetFilter는E_NOINTERFACEAVAILABLE 반환합니다. 호출이 성공하면 호스트는 IFolderFilter 인터페이스의 두 메서드를 호출하여 폴더의 내용을 열거하는 방법을 결정합니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll