IShellFolder::CreateViewObject

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

Creates a view object of a folder.

HRESULT CreateViewObject(

HWND hwndOwner,	// Handle of owner window
REFIID riid,	// Interface identifier
LPVOID *ppvOut	// Reserved
);

Parameters
hwndOwner
Specifies the owner window for any modal dialog boxes or message boxes within this call. It may be different from hwndParen passed in a call to IShellView::CreateViewWindow.

Handle of the owner window from which to create the view object.

riid

Identifier of the interface to return.

ppvOut

Specifies the address that receives a pointer to the view object.

Return Values
Returns NOERROR if successful or an OLE defined error value otherwiise.

Remarks
It is important to remember that the COM object created by CreateViewObject must be a different object than the shell folder object. The Explorer may call CreateViewObject more than once to create more than one view object and expects them to behave as independent objects. A new view object must be created for each call.