Funzione WaitMessage (winuser.h)
Restituisce il controllo ad altri thread quando un thread non contiene altri messaggi nella relativa coda di messaggi. La funzione WaitMessage sospende il thread e non restituisce finché non viene inserito un nuovo messaggio nella coda dei messaggi del thread.
Sintassi
BOOL WaitMessage();
Valore restituito
Tipo: BOOL
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Si noti che WaitMessage non restituisce se nella coda dei messaggi è presente un input non letto dopo che il thread ha chiamato una funzione per controllare la coda. Ciò è dovuto al fatto che funzioni come PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects e MsgWaitForMultipleObjectsEx controllano la coda e quindi modificano le informazioni sullo stato per la coda in modo che l'input non venga più considerato nuovo. Una chiamata successiva a WaitMessage non restituirà fino all'arrivo di un nuovo input del tipo specificato. L'input non letto esistente (ricevuto prima dell'ultima volta che il thread ha controllato la coda) viene ignorato.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-window-l1-1-4 (introdotto in Windows 10 versione 10.0.14393) |
Vedi anche
Informazioni concettuali
Riferimento