função CDefFolderMenu_Create2 (shlobj_core.h)

Artigo
08/26/2023

Cria um menu de contexto para um grupo selecionado de objetos de pasta de arquivo.

Sintaxe

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

Uma estrutura ITEMIDLIST para a pasta pai. Esse valor pode ser NULL.

[in, optional] hwnd

Digite: HWND

Um identificador para a janela pai. Esse valor pode ser NULL.

cidl

Tipo: UINT

O número de estruturas ITEMIDLIST na matriz apontada por apidl.

[in, optional] apidl

Tipo: PCUITEMID_CHILD_ARRAY*

Um ponteiro para uma matriz de estruturas ITEMIDLIST , uma para cada item selecionado.

[in, optional] psf

Tipo: IShellFolder*

Um ponteiro para a interface IShellFolder da pasta pai. Essa IShellFolder deve dar suporte à interface IDataObject . Caso contrário, CDefFolderMenu_Create2 falhará e retornará E_NOINTERFACE. Esse valor pode ser NULL.

[in, optional] pfn

Tipo: LPFNDFMCALLBACK

O objeto de retorno de chamada LPFNDFMCALLBACK . Esse valor poderá ser NULL se o objeto de retorno de chamada não for necessário.

nKeys

Tipo: UINT

O número de chaves do Registro na matriz apontada por ahkeys.

Nota O número máximo de chaves do Registro é 16. Os chamadores devem impor esse limite, pois a API não. Não fazer isso pode resultar em corrupção de memória.

[in, optional] ahkeys

Tipo: const HKEY*

Um ponteiro para uma matriz de chaves do Registro que especificam os manipuladores de menu de contexto usados com as entradas do menu. Para obter mais informações sobre manipuladores de menu de contexto, consulte Criando manipuladores de menu de contexto. Essa matriz pode conter no máximo 16 chaves do Registro.

[out] ppcm

Tipo: IContextMenu**

O endereço de um ponteiro de interface IContextMenu que, quando essa função retorna com êxito, aponta para o objeto IContextMenu que representa o menu de contexto.

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [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	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.00 ou posterior)

Confira também

SHCreateDefaultContextMenu

Compartilhar via