ICommDlgBrowser::IncludeObject 메서드(shobjidl_core.h)

공통 대화 상자에서 보기가 표시하는 개체를 필터링할 수 있습니다.

구문

HRESULT IncludeObject(
  IShellView      *ppshv,
  PCUITEMID_CHILD pidl
);

매개 변수

ppshv

형식: IShellView*

뷰의 IShellView 인터페이스에 대한 포인터입니다.

pidl

형식: LPCITEMIDLIST

개체를 식별하는 폴더를 기준으로 하는 PIDL입니다.

반환 값

형식: HRESULT

브라우저는 뷰에 개체를 포함하거나 S_FALSE 숨기려면 S_OK 반환해야 합니다.

설명

이 메서드는 파일 대화 상자에서 호스트되는 경우 IEnumIDList 구현에서 호출됩니다. 열거자는 이 메서드를 호출하여 일반 대화 상자가 표시되지 않아야 하는 개체를 필터링할 수 있도록 합니다. 일반적으로 파일 대화 상자는 항목의 표시 텍스트를 가져와서 확장명별로 필터링합니다.

호출 애플리케이션에 대한 참고 사항

Shell 폴더의 IDLIST 열거자에서 개체를 반환하기 전에 이 메서드를 호출합니다.

라이브러리 및 검색과 같은 항목이 많은 데이터 원본을 처리할 때 이 메서드에 대한 콜백으로 인해 성능이 저하됩니다. 이러한 상황을 방지하려면 GetViewFlags를 구현하고 CDB2GVF_NOINCLUDEITEM 반환합니다. 이렇게 하면 보기에서 ICommDlgBrowser::IncludeObject 호출을 건너뛸 수 있으므로 성능이 향상됩니다.

요구 사항

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

추가 정보

탐색기 브라우저 검색 샘플

ICommDlgBrowser