Método ISimpleFrameSite::P reMessageFilter (ocidl.h)

  • Artigo

Fornece a um site a oportunidade de processar uma mensagem recebida pela própria janela de um controle antes que o próprio controle faça qualquer processamento.

Sintaxe

HRESULT PreMessageFilter(
  [in]  HWND    hWnd,
  [in]  UINT    msg,
  [in]  WPARAM  wp,
  [in]  LPARAM  lp,
  [out] LRESULT *plResult,
  [out] DWORD   *pdwCookie
);

Parâmetros

[in] hWnd

Um identificador da janela de controle que recebe a mensagem.

[in] msg

A mensagem recebida pelo site de quadros simples.

[in] wp

O WPARAM da mensagem.

[in] lp

O LPARAM da mensagem.

[out] plResult

Um ponteiro para a variável que recebe o resultado do processamento da mensagem.

[out] pdwCookie

Um ponteiro para a variável que será passada para ISimpleFrameSite::P ostMessageFilter se ela for chamada posteriormente. Esse parâmetro só deverá conter dados alocados se esse método retornar S_OK para que ele também receba uma chamada para PostMessageFilter , que pode liberar a alocação. O chamador não é de forma alguma responsável por nada retornado nesse parâmetro.

Retornar valor

Esse método pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
 O site de quadros simples não usará a mensagem neste filtro para que mais processamento possa ocorrer.
S_FALSE
 O site processou a mensagem e nenhum processamento adicional deve ocorrer.
E_NOTIMPL
 O site não faz nenhuma filtragem de mensagens, indicando que PostMessageFilter não precisa ser chamado mais tarde.
E_POINTER
 O endereço em plResult ou pdwCookie não é válido.

Comentários

Valores retornados bem-sucedidos indicam se o site deseja permitir processamento adicional. S_OK indica processamento adicional, enquanto S_FALSE significa não processar mais. S_OK também indica que o controle deve chamar PostMessageFilter posteriormente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

ISimpleFrameSite