Função WaitMessage (winuser.h)

Bloqueia a execução de thread até que o thread precise processar uma nova mensagem. A nova mensagem pode ser uma mensagem de entrada, uma mensagem na fila ou uma mensagem não enfileirada.

Syntax

BOOL WaitMessage();

Return value

Type: BOOL

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. To get extended error information, call GetLastError.

Remarks

Note that WaitMessage does not return for unprocessed messages reported by a previous function which checks the queue. This is because functions such as PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects, and MsgWaitForMultipleObjectsEx check the queue and then change the state information for the queue so that the message is no longer considered new. A subsequent call to WaitMessage will not return until new messages arrive. As mensagens não processadas existentes (recebidas antes da última vez em que o thread verificou a fila) não são consideradas novas.

Requirements

See also

Conceptual

GetMessage

mensagens e filas de mensagens

PeekMessage

Reference