CDefFolderMenu_Create2-Funktion (shlobj_core.h)

  • Artikel

Erstellt ein Kontextmenü für eine ausgewählte Gruppe von Dateiordnerobjekten.

Syntax

SHSTDAPI CDefFolderMenu_Create2(
  [in, optional] PCIDLIST_ABSOLUTE     pidlFolder,
  [in, optional] HWND                  hwnd,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
  [in, optional] IShellFolder          *psf,
  [in, optional] LPFNDFMCALLBACK       pfn,
                 UINT                  nKeys,
  [in, optional] const HKEY            *ahkeys,
  [out]          IContextMenu          **ppcm
);

Parameter

[in, optional] pidlFolder

Typ: PCIDLIST_ABSOLUTE

Eine ITEMIDLIST-Struktur für den übergeordneten Ordner. Dieser Wert kann NULL sein.

[in, optional] hwnd

Typ: HWND

Ein Handle für das übergeordnete Fenster. Dieser Wert kann NULL sein.

cidl

Typ: UINT

Die Anzahl der ITEMIDLIST-Strukturen im Array, auf das von apidl verwiesen wird.

[in, optional] apidl

Typ: PCUITEMID_CHILD_ARRAY*

Ein Zeiger auf ein Array von ITEMIDLIST-Strukturen , eins für jedes ausgewählte Element.

[in, optional] psf

Typ: IShellFolder*

Ein Zeiger auf die IShellFolder-Schnittstelle des übergeordneten Ordners. Dieser IShellFolder muss die IDataObject-Schnittstelle unterstützen. Andernfalls schlägt CDefFolderMenu_Create2 fehl und gibt E_NOINTERFACE zurück. Dieser Wert kann NULL sein.

[in, optional] pfn

Typ: LPFNDFMCALLBACK

Das LPFNDFMCALLBACK-Rückrufobjekt . Dieser Wert kann NULL sein, wenn das Rückrufobjekt nicht benötigt wird.

nKeys

Typ: UINT

Die Anzahl der Registrierungsschlüssel im Array, auf die von ahkeys verwiesen wird.

Hinweis Die maximale Anzahl von Registrierungsschlüsseln ist 16. Aufrufer müssen diesen Grenzwert erzwingen, da die API dies nicht tut. Andernfalls kann dies zu Speicherbeschädigungen führen.
 

[in, optional] ahkeys

Typ: const HKEY*

Ein Zeiger auf ein Array von Registrierungsschlüsseln, das die Kontextmenühandler angibt, die mit den Einträgen des Menüs verwendet werden. Weitere Informationen zu Kontextmenühandlern finden Sie unter Erstellen von Kontextmenühandlern. Dieses Array kann maximal 16 Registrierungsschlüssel enthalten.

[out] ppcm

Typ: IContextMenu**

Die Adresse eines IContextMenu-Schnittstellenzeigers , der bei erfolgreicher Rückgabe dieser Funktion auf das IContextMenu-Objekt verweist, das das Kontextmenü darstellt.

Rückgabewert

Typ: HRESULT

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.00 oder höher)

Weitere Informationen

SHCreateDefaultContextMenu