WaitMessage-Funktion (winuser.h)

Blockiert die Threadausführung, bis der Thread eine neue Nachricht verarbeiten muss. Die neue Nachricht kann eine Eingabenachricht, eine in die Warteschlange eingereihte Nachricht oder eine nicht in die Warteschlange eingereihte Nachricht sein.

Syntax

BOOL WaitMessage();

Return value

Type: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. 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. Die vorhandenen nicht verarbeiteten Nachrichten (empfangen vor dem letzten Überprüfen des Threads) gelten nicht als neu.

Requirements

See also

Conceptual

GetMessage

Nachrichten- und Nachrichtenwarteschlangen

PeekMessage

Reference