WaitMessage

WaitMessage -Funktion führt-Steuerelement, um andere Threads, wenn ein Thread in die Warteschlange keine weiteren Nachrichten hat. Die WaitMessage -Funktion hält den Thread und wird nicht zurückgegeben, bis eine neue Nachricht in Warteschlange für den Thread gesetzt wird.

BOOL WaitMessage(VOID) 

Parameter

Diese Funktion hat keine Parameter.

Rückgabewerte

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Beachten Sie, dass WaitMessage nicht zurückgibt, wenn es gibt ungelesene Eingang in der Warteschlange, nachdem der Thread eine Funktion zum Überprüfen der Warteschlange aufgerufen wurde. Dies liegt daran, Funktionen wie PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects, und MsgWaitForMultipleObjectsEx überprüfen Sie die Warteschlange, und ändern Sie dann die Zustandsinformationen für die Warteschlange, so dass die Eingabe ist nicht mehr als neu. Ein nachfolgender Aufruf von WaitMessage wird erst kommt der neue Eingang des angegebenen Typs zurück. Die vorhandene ungelesene Beiträge (vor dem letzten Mal, das der Thread die Warteschlange aktiviert) wird ignoriert.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Nachrichten und Message Queues Übersicht, Message und Message Queue-Funktionen, GetMessage, PeekMessage

Index