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에 도입됨) |