IShellView::GetItemObject

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]

Returns an interface that refers to data presented in the view.

HRESULT GetItemObject(

UINT uItem,	// Specifies background object constants
REFIIDriid,	// Identifies the interface to return
LPVOID *ppv	// Address that receives the interface pointer
);

Parameters
uItem
Specifies constants that refer to an aspect of the view. It can be any of the following values.

Value	Meaning
SVGIO_BACKGROUND	Refers to the background of the view. It is used with IID_IContextMenu to get a context menu for the view background.
SVGIO_SELECTION	Refers to the currently selected items. IID_IDataObject uses this constant to get a data object that represents the selected items.
SVGIO_ALLVIEW	Same as SVGIO_SELECTION but refers to all items in the view.

riid
Identifier of the interface to return.

ppv

Address that receives the interface pointer. If an error occurs, the pointer returned must be NULL.

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

Remarks
Used by the common dialogs to get the selected items from the view.