Funzione SHCreateDefaultContextMenu (shlobj_core.h)

Articolo
03/02/2024

Crea un oggetto che rappresenta l'implementazione predefinita del menu di scelta rapida della shell.

Sintassi

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

Parametri

[in] pdcm

Tipo: const DEFCONTEXTMENU*

Puntatore a una struttura DEFCONTEXTMENU costante.

riid

Tipo: REFIID

Riferimento all'ID interfaccia dell'interfaccia su cui basare l'oggetto. Si tratta in genere dell'IID di IContextMenu, IContextMenu2 o IContextMenu3.

[out] ppv

Tipo: void**

Quando termina, questo metodo contiene il puntatore di interfaccia richiesto in riid.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione viene in genere usata nell'implementazione di IShellFolder::GetUIObjectOf. GetUIObjectOf crea un menu di scelta rapida che unisce i gestori IContextMenu specificati dalla struttura DEFCONTEXTMENU e può facoltativamente fornire implementazioni predefinite del verbo del menu di scelta rapida, ad esempio apertura, esplorazione, eliminazione e copia.

L'operazione di questa funzione è controllata dall'input specificato nella struttura DEFCONTEXTMENU . L'APICDefFolderMenu_Create2 è un altro modo per costruire l'implementazione del menu di scelta rapida predefinita. È meno espressivo di SHCreateDefaultContextMenu , ma esiste nelle piattaforme precedenti a Windows Vista.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (includere Shlobj.h)
DLL	Shell32.dll (versione 6.0.6000 o successiva)
Set di API	ext-ms-win-shell-shell32-l1-2-2 (introdotto in Windows 10, versione 10.0.14393)

Condividi tramite