IShellExtInit::Initialize

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]

Initializes a property sheet extension, context menu extension, or drag and drop handler.

HRESULT Initialize(

LPCITEMIDLIST pidlFolder,	// Points to an ITEMIDLIST structure
LPDATAOBJECT lpdobj,	// Points to an IDataObject interface
HKEY hkeyProgID	// Registry key for the file object or folder type
);

Parameters
pidlFolder

Pointer to an ITEMIDLIST (item identifier list) structure that uniquely identifies a folder. For property sheet extensions, this parameter is NULL. For context menu extensions, it is the IDList for the folder that cotains the item whose context menu is being displayed. For non-default drag-and-drop menu extensions, this parameter must specify the target folder.

lpdobj

Pointer to an IDataObject interface object that can be used to retrieve the objects being acted upon.

hkeyProgID

Registry key for the file object or folder type.

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

Remarks
The meanings of some parameters depend on the extension type. For drag and drop handlers, the item identifier list specifies the destination folder (the drop target), the IDataObject interface identifies the items being dropped, and the registry key specifies the file class of the destination folder.

For context menu extensions, the item identifier list specifies the folder that contains the selected file objects, the IDataObject interface identifies the selected file objects, and the registry key specifies the file class of the file object that has the focus.

Notes to Implementors
This is the first method that the shell calls after it creates an instance of a property sheet extension, context menu extension, or drag and drop handler.