IShellView3::CreateViewWindow3 method (shobjidl.h)

Article
02/22/2024

Requests the creation of a new Shell view window. The view can be either the right pane of Windows Explorer or the client window of a folder window. This method replaces CreateViewWindow2.

Syntax

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
);

Parameters

[in] psbOwner

Type: IShellBrowser*

A pointer to an IShellBrowser interface to provide namespace extension services.

[in] psvPrev

Type: IShellView*

A pointer to an IShellView interface that represents the previous view in the Windows Explorer or folder window.

[in] dwViewFlags

Type: SV3CVW3_FLAGS

Flags that specify details of the view being created.

SV3CVW3_DEFAULT

The default view.

SV3CVW3_NONINTERACTIVE

In the case of an error, the view should fail silently rather than displaying a UI.

SV3CVW3_FORCEVIEWMODE

The view mode set by IShellView3::CreateViewWindow3 overrides the saved view state.

SV3CVW3_FORCEFOLDERFLAGS

Folder flags set by IShellView3::CreateViewWindow3 override the saved view state.

[in] dwMask

Type: FOLDERFLAGS

A bitwise mask that specifies which folder options specified in dwFlags are to be used.

[in] dwFlags

Type: FOLDERFLAGS

A bitwise value that contains the folder options, as FOLDERFLAGS, to use in the new view.

[in] fvMode

Type: FOLDERVIEWMODE

A bitwise value that contains the folder view mode options, as FOLDERVIEWMODE, to use in the new view.

[in] pvid

Type: const SHELLVIEWID*

A pointer to Shell view ID as a GUID.

[in] prcView

Type: const RECT*

A pointer to a RECT structure that provides the dimensions of the view window.

[out] phwndView

Type: HWND*

A value that receives a pointer to the handle of the new Shell view window.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl.h

Share via