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)

另请参阅

SFV_CREATE

SHCreateShellFolderViewEx