SHCreateShellFolderView 函数 (shlobj_core.h)

(DefView) 创建默认 Shell 文件夹视图对象的新实例。

语法

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

[in] pcsfv

类型： const SFV_CREATE*

指向 SFV_CREATE 结构的指针，该结构描述在创建 Shell 文件夹视图对象的此实例时所使用的具体信息。

[out] ppsv

类型： IShellView**

此函数成功返回时，包含指向新 IShellView 对象的接口指针。失败时，此值为 NULL。

类型： HRESULT

如果此函数成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

对于 SHCreateShellFolderViewEx，建议使用 SHCreateShellFolderView，因为其元素可以更灵活地参与各种方案、为视图提供新功能以及与其他对象交互。

处理 IShellView 的多个实例时，可能需要验证哪个是默认的 Shell 文件夹视图对象。为此，请使用 IID_CDefView IID 对对象调用 QueryInterface 。仅当对默认 Shell 文件夹视图对象进行时，此调用才会成功。

使用默认 Shell 文件夹视图对象的数据源必须实现以下接口：

（可选）它们还可以实现 IPersistFolder3。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	shlobj_core.h (包括 Shlobj.h)
Library	Shell32.lib
DLL	Shell32.dll (5.0 或更高版本)
API 集	Windows 10版本 10.0.14393 中引入的 ext-ms-win-shell-shell32-l1- (2-2)