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


Функция WaitMessage (winuser.h)

Блокирует выполнение потока до тех пор, пока поток не должен обработать новое сообщение. Новое сообщение может быть входным сообщением, сообщением в очереди или не очередным сообщением.

Syntax

BOOL WaitMessage();

Return value

Type: BOOL

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. To get extended error information, call GetLastError.

Remarks

Note that WaitMessage does not return for unprocessed messages reported by a previous function which checks the queue. This is because functions such as PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects, and MsgWaitForMultipleObjectsEx check the queue and then change the state information for the queue so that the message is no longer considered new. A subsequent call to WaitMessage will not return until new messages arrive. Существующие необработанные сообщения (полученные до последнего времени проверки очереди) не считаются новыми.

Requirements

Requirement Value
Минимальный поддерживаемый клиент Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
Target Platform Windows
Header winuser.h (включая Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-window-l1-1-4 (представлено в Windows 10 версии 10.0.14393)

See also

Conceptual

GetMessage

сообщений и очередей сообщений

PeekMessage

Reference