SHCreateShellFolderView 함수(shlobj_core.h)

기본 Shell 폴더 뷰 개체(DefView)의 새 instance 만듭니다.

구문

SHSTDAPI SHCreateShellFolderView(
  [in]  const SFV_CREATE *pcsfv,
  [out] IShellView       **ppsv
);

매개 변수

[in] pcsfv

형식: const SFV_CREATE*

Shell 폴더 뷰 개체의 이 instance 만드는 데 사용되는 세부 사항을 설명하는 SFV_CREATE 구조체에 대한 포인터입니다.

[out] ppsv

형식: IShellView**

이 함수가 성공적으로 반환되면 는 새 IShellView 개체에 대한 인터페이스 포인터를 포함합니다. 실패 시 이 값은 NULL입니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

SHCreateShellFolderView 는 다양한 시나리오에 참여하고, 뷰에 새로운 기능을 제공하고, 다른 개체와 상호 작용할 수 있는 요소의 유연성이 높기 때문에 SHCreateShellFolderViewEx 보다 권장됩니다.

IShellView의 여러 인스턴스를 처리할 때 기본 셸 폴더 뷰 개체가 무엇인지 확인할 수 있습니다. 이렇게 하려면 IID_CDefView IID를 사용하여 개체에서 QueryInterface 를 호출합니다. 이 호출은 기본 Shell 폴더 뷰 개체에서 수행되는 경우에만 성공합니다.

기본 Shell 폴더 뷰 개체를 사용하는 데이터 원본은 다음 인터페이스를 구현해야 합니다.

필요에 따라 IPersistFolder3을 구현할 수도 있습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 shlobj_core.h(Shlobj.h 포함)
라이브러리 Shell32.lib
DLL Shell32.dll(버전 5.0 이상)
API 세트 ext-ms-win-shell-shell32-l1-2-2(Windows 10 버전 10.0.14393에 도입됨)

추가 정보

SFV_CREATE

SHCreateShellFolderViewEx