función CDefFolderMenu_Create2 (shlobj_core.h)

Crea un menú contextual para un grupo seleccionado de objetos de carpeta de archivos.

Sintaxis

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
);

Parámetros

[in, optional] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Estructura ITEMIDLIST para la carpeta primaria. Este valor puede ser NULL.

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria. Este valor puede ser NULL.

cidl

Tipo: UINT

Número de estructuras ITEMIDLIST de la matriz a la que apunta apidl.

[in, optional] apidl

Tipo: PCUITEMID_CHILD_ARRAY*

Puntero a una matriz de estructuras ITEMIDLIST , una para cada elemento seleccionado.

[in, optional] psf

Tipo: IShellFolder*

Puntero a la interfaz IShellFolder de la carpeta primaria. Este IShellFolder debe admitir la interfaz IDataObject . Si no es así, CDefFolderMenu_Create2 produce un error y devuelve E_NOINTERFACE. Este valor puede ser NULL.

[in, optional] pfn

Tipo: LPFNDFMCALLBACK

Objeto de devolución de llamada LPFNDFMCALLBACK . Este valor puede ser NULL si no se necesita el objeto de devolución de llamada.

nKeys

Tipo: UINT

Número de claves del Registro de la matriz a las que apuntan los ahkeys.

Nota El número máximo de claves del Registro es 16. Los autores de llamadas deben aplicar este límite, ya que la API no lo hace. Si no lo hace, puede provocar daños en la memoria.

 

[in, optional] ahkeys

Tipo: const HKEY*

Puntero a una matriz de claves del Registro que especifican los controladores de menú contextual usados con las entradas del menú. Para obtener más información sobre los controladores de menú contextual, vea Crear controladores de menú contextual. Esta matriz puede contener un máximo de 16 claves del Registro.

[out] ppcm

Tipo: IContextMenu**

La dirección de un puntero de interfaz IContextMenu que, cuando esta función vuelve correctamente, apunta al objeto IContextMenu que representa el menú contextual.

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.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 5.00 o posterior)

Consulte también

SHCreateDefaultContextMenu