IShellExtInit::InitializeIShellExtInit::Initialize*
*Contents  *Index  *Topic Contents
*Previous Topic: IShellExtInit
*Next Topic: IShellFolder

IShellExtInit::Initialize


HRESULT Initialize(
    LPCITEMIDLIST pidlFolder,
    LPDATAOBJECT lpdobj,
    HKEY hkeyProgID
   );

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

pidlFolder
Address of an ITEMIDLIST structure that uniquely identifies a folder. For property sheet extensions, this parameter is NULL. For context menu extensions, it is the item identifier list for the folder that contains the item whose context menu is being displayed. For nondefault drag-and-drop menu extensions, this parameter specifies the target folder.
lpdobj
Address of 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.

The meanings of some parameters depend on the extension type. For drag-and-drop handlers, the pidlFolder parameter specifies the destination folder (the drop target), the lpdobj parameter identifies the items being dropped, and the hkeyProgID parameter specifies the file class of the destination folder.

For context menu extensions, pidlFolder specifies the folder that contains the selected file objects, lpdobj identifies the selected file objects, and hkeyProgID specifies the file class of the file object that has the focus.

For property sheet extensions, pidlFolder is NULL, lpdobj identifies the selected file objects, and hkeyProgID specifies the file class of the file object that has the focus.

Notes to Implementers

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

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.