WaitMessage-Funktion (winuser.h)

Gibt anderen Threads die Kontrolle, wenn ein Thread keine anderen Nachrichten in seiner Nachrichtenwarteschlange enthält. Die WaitMessage-Funktion hält den Thread an und gibt erst zurück, wenn eine neue Nachricht in die Nachrichtenwarteschlange des Threads eingefügt wird.

Syntax

BOOL WaitMessage();

Rückgabewert

Typ: BOOL

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Beachten Sie, dass WaitMessage nicht zurückgibt, wenn in der Nachrichtenwarteschlange ungelesene Eingaben vorhanden sind, nachdem der Thread eine Funktion zum Überprüfen der Warteschlange aufgerufen hat. Dies liegt daran, dass Funktionen wie PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects und MsgWaitForMultipleObjectsEx die Warteschlange überprüfen und dann die Statusinformationen für die Warteschlange ändern, sodass die Eingabe nicht mehr als neu betrachtet wird. Ein anschließender Aufruf von WaitMessage wird erst zurückgegeben, wenn eine neue Eingabe des angegebenen Typs eintrifft. Die vorhandene ungelesene Eingabe (die vor dem letzten Überprüfen der Warteschlange vom Thread empfangen wurde) wird ignoriert.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-4 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Konzept

GetMessage

Nachrichten und Nachrichtenwarteschlangen

PeekMessage

Referenz