IShellView3::CreateViewWindow3 method

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

psbOwner [in]

Type: IShellBrowser*

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

psvPrev [in]

Type: IShellView*

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

dwViewFlags [in]

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.

dwMask [in]

Type: FOLDERFLAGS

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

dwFlags [in]

Type: FOLDERFLAGS

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

fvMode [in]

Type: FOLDERVIEWMODE

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

pvid [in]

Type: const SHELLVIEWID*

A pointer to Shell view ID as a GUID.

prcView [in]

Type: const RECT*

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

phwndView [out]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Show: