Função SHCreateDefaultContextMenu (shlobj_core.h)

Cria um objeto que representa a implementação do menu de contexto padrão do Shell.

Sintaxe

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

Parâmetros

[in] pdcm

Tipo: const DEFCONTEXTMENU*

Um ponteiro para uma estrutura DEFCONTEXTMENU constante.

riid

Tipo: REFIID

Referência à ID da interface na qual basear o objeto. Normalmente, esse é o IID de IContextMenu, IContextMenu2 ou IContextMenu3.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface solicitado em riid.

Retornar valor

Tipo: HRESULT

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

Comentários

Essa função normalmente é usada na implementação de IShellFolder::GetUIObjectOf. GetUIObjectOf cria um menu de contexto que mescla manipuladores IContextMenu especificados pela estrutura DEFCONTEXTMENU e, opcionalmente, pode fornecer implementações de verbo de menu de contexto padrão, como abrir, explorar, excluir e copiar.

A operação dessa função é controlada pela entrada especificada na estrutura DEFCONTEXTMENU . OCDefFolderMenu_Create2 de API é outra maneira de construir a implementação do menu de contexto padrão. Ele é menos expressivo que SHCreateDefaultContextMenu , mas existe em plataformas anteriores ao Windows Vista.

Requisitos