Função WaitMessage (winuser.h)
Gera controle para outros threads quando um thread não tem outras mensagens em sua fila de mensagens. A função WaitMessage suspende o thread e não retorna até que uma nova mensagem seja colocada na fila de mensagens do thread.
Sintaxe
BOOL WaitMessage();
Valor retornado
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Observe que WaitMessage não retornará se houver entrada não lida na fila de mensagens depois que o thread tiver chamado uma função para marcar fila. Isso ocorre porque funções como PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects e MsgWaitForMultipleObjectsEx marcar fila e altere as informações de estado da fila para que a entrada não seja mais considerada nova. Uma chamada subsequente para WaitMessage não retornará até que uma nova entrada do tipo especificado chegue. A entrada não lida existente (recebida antes da última vez em que o thread verificou a fila) é ignorada.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-window-l1-1-4 (introduzido no Windows 10, versão 10.0.14393) |
Confira também
Conceitual
Mensagens e filas de mensagens
Referência