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