SHCreateDefaultContextMenu-Funktion (shlobj_core.h)

Artikel
08/08/2024

Erstellt ein -Objekt, das die Standardimplementierung des Kontextmenüs der Shell darstellt.

Syntax

SHSTDAPI SHCreateDefaultContextMenu(
  [in]  const DEFCONTEXTMENU *pdcm,
        REFIID               riid,
  [out] void                 **ppv
);

Parameter

[in] pdcm

Typ: const DEFCONTEXTMENU*

Ein Zeiger auf eine konstante DEFCONTEXTMENU-Struktur .

riid

Typ: REFIID

Verweis auf die Schnittstellen-ID der Schnittstelle, auf der das Objekt basieren soll. Dies ist in der Regel die IID von IContextMenu, IContextMenu2 oder IContextMenu3.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion wird in der Regel in der Implementierung von IShellFolder::GetUIObjectOf verwendet. GetUIObjectOf erstellt ein Kontextmenü, in dem IContextMenu-Handler zusammengeführt werden, die von der DEFCONTEXTMENU-Struktur angegeben werden, und optional Standardimplementierungen von Kontextmenüverben wie Öffnen, Durchsuchen, Löschen und Kopieren bereitstellen können.

Der Betrieb dieser Funktion wird durch die in der DEFCONTEXTMENU-Struktur angegebene Eingabe gesteuert. DieAPI-CDefFolderMenu_Create2 ist eine weitere Möglichkeit, die Standardkontextmenüimplementierung zu erstellen. Es ist weniger ausdrucksstark als SHCreateDefaultContextMenu , aber es existiert auf Plattformen vor Windows Vista.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (shlobj.h einschließen)
DLL	Shell32.dll (Version 6.0.6000 oder höher)
APIs	ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)

Freigeben über