IShellFolder::GetUIObjectOf

[Now Supported on Windows NT]

Creates a COM object that can be used to carry out actions on the specified file objects or folders, typically, to create context menus or carry out drag-and-drop operations.

HRESULT GetUIObjectOf(

HWND hwndOwner,	// Handle to owner window
UINT cidl,	// Number of objects specified in apidl
LPCITEMIDLIST *apidl,	// Pointer to an array of pointers to an ITEMIDLIST structure
REFIID riid,	// Interface to return
UINT *prgfInOut,	// Reserved
LPVOID *ppvOut	// Address to receive interface pointer
);

Parameters

hwndOwner

Handle of the owner window that the client should specify if it displays a dialog box or message box.

cidl

Number of file objects or subfolders specified by apidl.

apidl

Pointer to an array of pointers to ITEMIDLIST structures, each of which uniquely identifies a file object or subfolder relative to the parent folder. Each item identifier list must contain exactly one SHITEMID structure followed by a terminating zero.

riid

Specifies the type and the interface of the COM object to return. This parameter can be a pointer to the IID_IExtractIcon, IID_IContextMenu, IID_IDataObject, or IID_IDropTarget interface identifier.

prgfInOut

Reserved.

ppvOut

Address that receives the interface pointer. If an error occurs, a NULL pointer is returned in this address.

Return Values

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

Remarks

GetUIObjectOf creates a UI object to be used for specified objects. Either IID_IDataObject (transfer operations) or IID_IContextMenu (context menu operations) is passed in the riid parameter.

See Also

IShellFolder, ITEMIDLIST, SHITEMID

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples