Função de retorno de chamada LPFNDFMCALLBACK (shlobj_core.h)

Artigo
08/26/2023

[LPFNDFMCALLBACK está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Define o protótipo para a função de retorno de chamada que recebe mensagens da implementação do menu de contexto padrão do Shell.

Sintaxe

LPFNDFMCALLBACK Lpfndfmcallback;

HRESULT Lpfndfmcallback(
  [in, optional] IShellFolder *psf,
  [in, optional] HWND hwnd,
  [in, optional] IDataObject *pdtobj,
                 UINT uMsg,
                 WPARAM wParam,
                 LPARAM lParam
)
{...}

Parâmetros

[in, optional] psf

Tipo: IShellFolder*

Um ponteiro para o objeto IShellFolder ao qual a mensagem se aplica. Esse valor pode ser NULL.

[in, optional] hwnd

Digite: HWND

O identificador da janela que contém a exibição. Esse valor pode ser NULL.

[in, optional] pdtobj

Tipo: IDataObject*

IDataObject que representa a seleção na qual o menu de contexto se baseia. Esse valor pode ser NULL.

uMsg

Tipo: UINT

Uma das notificações a seguir.

Notification	Uso
DFM_MERGECONTEXTMENU	Enviado pela implementação do menu de contexto padrão para permitir que LPFNDFMCALLBACK adicione itens ao menu.
DFM_INVOKECOMMAND	Enviado pela implementação do menu de contexto padrão para solicitar LPFNDFMCALLBACK para invocar um comando de menu.
DFM_GETDEFSTATICID	Enviado pela implementação do menu de contexto padrão quando o comando de menu padrão está sendo criado, permitindo que uma opção alternativa seja feita.

wParam

Tipo: WPARAM

Informações adicionais. Consulte as páginas de notificação individuais para obter requisitos específicos.

lParam

Tipo: LPARAM

Informações adicionais. Consulte as páginas de notificação individuais para obter requisitos específicos.

Retornar valor

Tipo: HRESULT

Retorna S_OK se a mensagem foi tratada ou um valor de erro, caso contrário, incluindo o seguinte:

Código de retorno	Descrição
E_NOTIMPL	A mensagem não foi tratada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	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)