IShellExtInit::Initialize - Win32 Programmer's Reference (win32.hlp)

Win32 Programmer's Reference

Index Commented Search About

Quick Info

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

IShellExtInit::Initialize

[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.

See Also
IShellExtInit, ITEMIDLIST

More Online Helps

Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages

greatis just4fun network