Método IShellMenu::GetShellFolder (shobjidl_core.h)

Obtiene la carpeta en la que se establece la banda de menús para examinar.

Sintaxis

HRESULT GetShellFolder(
  [out] DWORD            *pdwFlags,
  [out] PIDLIST_ABSOLUTE *ppidl,
  [in]  REFIID           riid,
  [out] void             **ppv
);

Parámetros

[out] pdwFlags

Tipo: DWORD*

Cuando este método se devuelve correctamente, contiene un puntero a un conjunto de valores de marca que especifican cómo funciona la banda de menús.

Puede devolver cualquiera de las marcas siguientes.

Valor	Significado
SMINIT_DEFAULT	No hay opciones.
SMINIT_RESTRICT_DRAGDROP	No permita arrastrar y colocar.
SMINIT_TOPLEVEL	Esta es la banda superior.
SMINIT_CACHED	No destruya la banda cuando se cierre la ventana.

 

Siempre devuelve una de las marcas siguientes.

Valor	Significado
SMINIT_VERTICAL	Especifica una banda vertical.
SMINIT_HORIZONTAL	Especifica una banda horizontal.

[out] ppidl

Tipo: PCIDLIST_ABSOLUTE*

Cuando este método finaliza, contiene la dirección de itemIDLIST completo de la carpeta.

[in] riid

Tipo: REFIID

REFIID para la carpeta de destino.

[out] ppv

Tipo: void**

Cuando este método se devuelve correctamente, contiene la dirección de un puntero al objeto de carpeta shell al que hace referencia el riid.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)
Archivo DLL	Shell32.dll