IShellExtInit::Initialize method (shobjidl_core.h)

Article
10/13/2021

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

Syntax

HRESULT Initialize(
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] IDataObject       *pdtobj,
  [in] HKEY              hkeyProgID
);

Parameters

[in] pidlFolder

Type: PCIDLIST_ABSOLUTE

A pointer to an ITEMIDLIST structure that uniquely identifies a folder. For property sheet extensions, this parameter is NULL. For shortcut menu extensions, it is the item identifier list for the folder that contains the item whose shortcut menu is being displayed. For nondefault drag-and-drop menu extensions, this parameter specifies the target folder.

[in] pdtobj

Type: IDataObject*

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

[in] hkeyProgID

Type: HKEY

The registry key for the file object or folder type.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

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 pdtobj parameter identifies the items being dropped, and the hkeyProgID parameter specifies the file type of the destination folder.

For shortcut menu extensions, pdtobj identifies the selected file objects, hkeyProgID identifies the file type of the object with focus, and pidlFolder is either NULL (for file objects) or specifies the folder for which the shortcut menu is being requested (for folder background shortcut menus).

For property sheet extensions, pidlFolder is NULL, pdtobj identifies the selected file objects, and hkeyProgID specifies the file type 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, shortcut menu extension, or drag-and-drop handler.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (version 4.0 or later)

Share via