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

  • Artigo

Obtém a pasta que a faixa de menu está definida para navegar.

Sintaxe

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

Parâmetros

[out] pdwFlags

Tipo: DWORD*

Quando esse método retorna com êxito, contém um ponteiro para um conjunto de valores de sinalizador que especificam como a banda de menu opera.

Pode retornar qualquer um dos sinalizadores a seguir.

Valor Significado
SMINIT_DEFAULT
 Não há opções.
SMINIT_RESTRICT_DRAGDROP
 Não permita arrastar e soltar.
SMINIT_TOPLEVEL
 Esta é a melhor banda.
SMINIT_CACHED
 Não destrua a banda quando a janela estiver fechada.
 

Sempre retorna um dos sinalizadores a seguir.

Valor Significado
SMINIT_VERTICAL
 Especifica uma faixa vertical.
SMINIT_HORIZONTAL
 Especifica uma faixa horizontal.

[out] ppidl

Tipo: PCIDLIST_ABSOLUTE*

Quando esse método retorna, contém o endereço do ITEMIDLIST totalmente qualificado da pasta.

[in] riid

Tipo: REFIID

O REFIID da pasta de destino.

[out] ppv

Tipo: void**

Quando esse método retorna com êxito, contém o endereço de um ponteiro para o objeto de pasta Shell referenciado pelo riid.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll