WaitMessage, fonction (winuser.h)
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
Messages et files d’attente de messages
Référence