IShellView3::CreateViewWindow3 方法 (shobjidl.h)

请求创建新的 Shell 视图窗口。 视图可以是 Windows 资源管理器的右窗格,也可以是文件夹窗口的客户端窗口。 此方法替换 CreateViewWindow2

语法

HRESULT CreateViewWindow3(
  [in]  IShellBrowser     *psbOwner,
  [in]  IShellView        *psvPrev,
  [in]  SV3CVW3_FLAGS     dwViewFlags,
  [in]  FOLDERFLAGS       dwMask,
  [in]  FOLDERFLAGS       dwFlags,
  [in]  FOLDERVIEWMODE    fvMode,
  [in]  const SHELLVIEWID *pvid,
  [in]  const RECT        *prcView,
  [out] HWND              *phwndView
);

参数

[in] psbOwner

类型: IShellBrowser*

指向 IShellBrowser 接口的指针,用于提供命名空间扩展服务。

[in] psvPrev

类型: IShellView*

指向 IShellView 接口的指针,该接口表示 Windows 资源管理器或文件夹窗口中的上一个视图。

[in] dwViewFlags

类型: SV3CVW3_FLAGS

指定所创建的视图详细信息的标志。

SV3CVW3_DEFAULT

默认视图。

SV3CVW3_NONINTERACTIVE

如果出现错误,视图应以无提示方式失败,而不是显示 UI。

SV3CVW3_FORCEVIEWMODE

IShellView3::CreateViewWindow3 设置的视图模式将覆盖保存的视图状态。

SV3CVW3_FORCEFOLDERFLAGS

IShellView3::CreateViewWindow3 设置的文件夹标志将覆盖保存的视图状态。

[in] dwMask

类型: FOLDERFLAGS

指定将使用 dwFlags 中指定的文件夹选项的按位掩码。

[in] dwFlags

类型: FOLDERFLAGS

包含文件夹选项(作为 FOLDERFLAGS)的按位值,用于新视图。

[in] fvMode

类型: FOLDERVIEWMODE

一个包含文件夹视图模式选项(作为 FOLDERVIEWMODE)的按位值,用于新视图。

[in] pvid

类型: const SHELLVIEWID*

指向 SHELL 视图 ID 作为 GUID 的指针。

[in] prcView

类型: const RECT*

指向提供视图窗口维度的 RECT 结构的指针。

[out] phwndView

类型: HWND*

一个 值,该值接收指向新 Shell 视图窗口的句柄的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl.h