Funzione WaitMessage (winuser.h)

  • Articolo

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

GetMessage

Messaggi e code di messaggi

PeekMessage

Riferimento