WaitMessage, fonction (winuser.h)

  • Article

Renvoie le contrôle à d’autres threads lorsqu’un thread n’a pas d’autres messages dans sa file d’attente de messages. La fonction WaitMessage suspend le thread et ne retourne pas tant qu’un nouveau message n’est pas placé dans la file d’attente des messages du thread.

Syntaxe

BOOL WaitMessage();

Valeur de retour

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notez que WaitMessage ne retourne pas s’il existe une entrée non lus dans la file d’attente de messages après que le thread a appelé une fonction pour case activée la file d’attente. En effet, les fonctions telles que PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects et MsgWaitForMultipleObjectsEx case activée la file d’attente, puis modifient les informations d’état de la file d’attente afin que l’entrée ne soit plus considérée comme nouvelle. Un appel ultérieur à WaitMessage ne retournera pas tant qu’une nouvelle entrée du type spécifié n’est pas arrivée. L’entrée non lus existante (reçue avant la dernière vérification de la file d’attente par le thread) est ignorée.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-window-l1-1-4 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

Conceptuel

GetMessage

Messages et files d’attente de messages

PeekMessage

Référence