Поделиться через

Метод ISimpleFrameSite::P reMessageFilter (ocidl.h)

  • Статья

Предоставляет сайту возможность обработать сообщение, полученное собственным окном элемента управления, до того, как сам элемент управления будет выполнять какую-либо обработку.

Синтаксис

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

Параметры

[in] hWnd

Дескриптор окна управления, получающего сообщение.

[in] msg

Сообщение, полученное простым сайтом фрейма.

[in] wp

WPARAM сообщения.

[in] lp

LPARAM сообщения.

[out] plResult

Указатель на переменную, которая получает результат обработки сообщения.

[out] pdwCookie

Указатель на переменную, которая будет передана в ISimpleFrameSite::P ostMessageFilter , если она будет вызвана позже. Этот параметр должен содержать выделенные данные, только если этот метод возвращает S_OK поэтому он также получит вызов PostMessageFilter , который может освободить выделение. Вызывающий объект никак не несет ответственности за что-либо, возвращаемое в этом параметре.

Возвращаемое значение

Этот метод может возвращать следующие значения.

Код возврата Описание
S_OK
 Простой сайт фрейма не будет использовать сообщение в этом фильтре, поэтому может выполняться дополнительная обработка.
S_FALSE
 Сайт обработал сообщение, и дальнейшая обработка не должна выполняться.
E_NOTIMPL
 Сайт не выполняет фильтрацию сообщений, указывая, что PostMessageFilter не требуется вызывать позже.
E_POINTER
 Недопустимый адрес в plResult или pdwCookie .

Комментарии

Успешные возвращаемые значения указывают, хочет ли сайт разрешить дальнейшую обработку. S_OK указывает на дальнейшую обработку, тогда как S_FALSE означает, что дальнейшая обработка не выполняется. S_OK также указывает, что элемент управления должен позже вызвать PostMessageFilter.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

См. также раздел

ISimpleFrameSite