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
Nachrichten und Nachrichtenwarteschlangen
Referenz