SHCreateDefaultContextMenu-Funktion (shlobj_core.h)

Erstellt ein Objekt, das die Standardmäßige Kontextmenüimplementierung der Shell darstellt.

Syntax

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

Die Parameter

[in] pdcm

Typ: const DEFCONTEXTMENU*

Ein Zeiger auf eine konstante DEFCONTEXTMENU-Struktur .

riid

Typ: REFIID

Verweisen Sie 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ückgegeben wird, enthält sie den in riid angeforderten Schnittstellenzeiger.

Rückgabewert

Typ: HRESULT-

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

Bemerkungen

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 durch die DEFCONTEXTMENU-Struktur angegeben sind, und optional Standardimplementierungen für Kontextmenüs wie Öffnen, Durchsuchen, Löschen und Kopieren bereitstellen können.

Der Vorgang dieser Funktion wird durch die in der DEFCONTEXTMENU-Struktur angegebene Eingabe gesteuert. DieAPI-CDefFolderMenu_Create2 ist eine weitere Möglichkeit, die Standardimplementierung des Kontextmenüs zu erstellen. Es ist weniger ausdrucksstark als SHCreateDefaultContextMenu , aber es ist auf Plattformen vor Windows Vista vorhanden.

Anforderungen