Compartir a través de

Función SHCreateDefaultContextMenu (shlobj_core.h)

  • Artículo

Crea un objeto que representa la implementación predeterminada del menú contextual del Shell.

Sintaxis

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

Parámetros

[in] pdcm

Tipo: const DEFCONTEXTMENU*

Puntero a una estructura DEFCONTEXTMENU constante.

riid

Tipo: REFIID

Referencia al identificador de interfaz de la interfaz en la que se va a basar el objeto. Normalmente es el IID de IContextMenu, IContextMenu2 o IContextMenu3.

[out] ppv

Tipo: void**

Cuando este método devuelve, contiene el puntero de interfaz solicitado en riid.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función se usa normalmente en la implementación de IShellFolder::GetUIObjectOf. GetUIObjectOf crea un menú contextual que combina controladores IContextMenu especificados por la estructura DEFCONTEXTMENU y, opcionalmente, puede proporcionar implementaciones de verbos de menú contextual predeterminados, como abrir, explorar, eliminar y copiar.

La operación de esta función se controla mediante la entrada especificada en la estructura DEFCONTEXTMENU . La APICDefFolderMenu_Create2 es otra manera de construir la implementación predeterminada del menú contextual. Es menos expresivo que SHCreateDefaultContextMenu , pero existe en plataformas anteriores a Windows Vista.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Archivo DLL Shell32.dll (versión 6.0.6000 o posterior)
Conjunto de API ext-ms-win-shell-shell32-l1-2-2 (introducido en Windows 10, versión 10.0.14393)