IShellView3::CreateViewWindow3 method (shobjidl.h)
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 |