IShellExtInit::Initialize-Methode (shobjidl_core.h)

Artikel
08/26/2023

Initialisiert eine Eigenschaftenblatterweiterung, eine Kontextmenüerweiterung oder einen Drag-and-Drop-Handler.

Syntax

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

Parameter

[in] pidlFolder

Typ: PCIDLIST_ABSOLUTE

Ein Zeiger auf eine ITEMIDLIST-Struktur , die einen Ordner eindeutig identifiziert. Für Eigenschaftenblatterweiterungen ist dieser Parameter NULL. Bei Kontextmenüerweiterungen ist es die Elementbezeichnerliste für den Ordner, die das Element enthält, dessen Kontextmenü angezeigt wird. Für nicht standardmäßige Drag-and-Drop-Menüerweiterungen gibt dieser Parameter den Zielordner an.

[in] pdtobj

Typ: IDataObject*

Ein Zeiger auf ein IDataObject-Schnittstellenobjekt , das zum Abrufen der Objekte verwendet werden kann, auf die reagiert wird.

[in] hkeyProgID

Typ: HKEY

Der Registrierungsschlüssel für das Dateiobjekt oder den Ordnertyp.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Bedeutung einiger Parameter hängt vom Erweiterungstyp ab. Für Drag-and-Drop-Handler gibt der pidlFolder-Parameter den Zielordner (das Ablageziel) an, der pdtobj-Parameter identifiziert die gelöschten Elemente, und der hkeyProgID-Parameter gibt den Dateityp des Zielordners an.

Bei Kontextmenüerweiterungen identifiziert pdtobj die ausgewählten Dateiobjekte, hkeyProgID identifiziert den Dateityp des Objekts mit Fokus, und pidlFolder ist entweder NULL (für Dateiobjekte) oder gibt den Ordner an, für den das Kontextmenü angefordert wird (für Kontextmenüs im Ordnerhintergrund).

Bei Eigenschaftenblatterweiterungen ist pidlFolderNULL, pdtobj identifiziert die ausgewählten Dateiobjekte, und hkeyProgID gibt den Dateityp des Dateiobjekts an, das den Fokus hat.

Hinweise für Implementierer

Dies ist die erste Methode, die die Shell aufruft, nachdem sie eine instance einer Eigenschaftenblatterweiterung, Kontextmenüerweiterung oder Drag-and-Drop-Handler erstellt hat.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll (Version 4.0 oder höher)

Freigeben über