IShellView::CreateViewWindow method (shobjidl_core.h)

Creates a view window. This can be either the right pane of Windows Explorer or the client window of a folder window.


HRESULT CreateViewWindow(
  [in]  IShellView        *psvPrevious,
  [in]  IShellBrowser     *psb,
  [in]  RECT              *prcView,
  [out] HWND              *phWnd


[in] psvPrevious

Type: IShellView*

The address of the IShellView interface of the view window being exited. Views can use this parameter to communicate with a previous view of the same implementation. This interface can be used to optimize browsing between like views. This pointer may be NULL.

[in] pfs


The address of a FOLDERSETTINGS structure. The view should use this when creating its view.

[in] psb

Type: IShellBrowser*

The address of the current instance of the IShellBrowser interface. The view should call this interface's AddRef method and keep the interface pointer to allow communication with the Windows Explorer window.

[in] prcView

Type: RECT*

The dimensions of the new view, in client coordinates.

[out] phWnd

Type: HWND*

The address of the window handle being created.

Return value


Returns a success code if successful, or a COM error code otherwise. Use the SUCCEEDED and FAILED macros to determine whether the operation succeeded or failed.


Notes to Calling applications

Call this method when the view needs to be created.

Notes to Implementers

Create your view window and restore any persistent state by calling the GetViewStateStream method. Store the IShellBrowser pointer for further use.


Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (version 4.0 or later)

See also