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

  • Artículo

Proporciona a un sitio la oportunidad de procesar un mensaje recibido por la propia ventana de un control antes de que el propio control realice cualquier procesamiento.

Sintaxis

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

Parámetros

[in] hWnd

Identificador de la ventana de control que recibe el mensaje.

[in] msg

Mensaje recibido por el sitio de marco simple.

[in] wp

WPARAM del mensaje.

[in] lp

LPARAM del mensaje.

[out] plResult

Puntero a la variable que recibe el resultado del procesamiento del mensaje.

[out] pdwCookie

Puntero a la variable que se pasará a ISimpleFrameSite::P ostMessageFilter si se llama más adelante. Este parámetro solo debe contener datos asignados si este método devuelve S_OK, por lo que también recibirá una llamada a PostMessageFilter que puede liberar la asignación. El autor de la llamada no es responsable de nada devuelto en este parámetro.

Valor devuelto

Este método puede devolver los valores siguientes.

Código devuelto Descripción
S_OK
 El sitio de marco simple no usará el mensaje en este filtro para que se pueda realizar más procesamiento.
S_FALSE
 El sitio ha procesado el mensaje y no se debe realizar ningún procesamiento adicional.
E_NOTIMPL
 El sitio no realiza ningún filtrado de mensajes, lo que indica que no es necesario llamar a PostMessageFilter más adelante.
E_POINTER
 La dirección de plResult o pdwCookie no es válida.

Comentarios

Los valores devueltos correctos indican si el sitio desea permitir un procesamiento adicional. S_OK indica un procesamiento adicional, mientras que S_FALSE significa que no se procesan más. S_OK también indica que el control debe llamar posteriormente a PostMessageFilter.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

ISimpleFrameSite