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


Метод ITfMessagePump::P eekMessageA (msctf.h)

Получает сообщение из очереди сообщений и возвращает значение , если сообщение не получено. Это версия ANSI этого метода.

Синтаксис

HRESULT PeekMessageA(
  [out] LPMSG pMsg,
  [in]  HWND  hwnd,
  [in]  UINT  wMsgFilterMin,
  [in]  UINT  wMsgFilterMax,
  [in]  UINT  wRemoveMsg,
  [out] BOOL  *pfResult
);

Параметры

[out] pMsg

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

[in] hwnd

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

[in] wMsgFilterMin

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

[in] wMsgFilterMax

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

[in] wRemoveMsg

Указывает способ обработки сообщений. Дополнительные сведения см. в разделе Функция PeekMessage .

[out] pfResult

Указатель на BOOL, получающий возвращаемое значение от функции PeekMessage .

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

Этот метод может возвращать одно из этих значений.

Значение Описание
S_OK
Метод выполнен успешно.
E_INVALIDARG
Один или несколько параметров являются недопустимыми.

Комментарии

Если wMsgFilterMin и wMsgFilterMax равны нулю , этот метод возвращает все доступные сообщения; то есть фильтрация по диапазонам не выполняется.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header msctf.h
DLL Msctf.dll
Распространяемые компоненты TSF 1.0 в Windows 2000 Профессиональная

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

ITfMessagePump

MSG

PeekMessage