Share via

Función WaitMessage (winuser.h)

  • Artículo

Produce el control en otros subprocesos cuando un subproceso no tiene ningún otro mensaje en su cola de mensajes. La función WaitMessage suspende el subproceso y no devuelve hasta que se coloca un nuevo mensaje en la cola de mensajes del subproceso.

Sintaxis

BOOL WaitMessage();

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Tenga en cuenta que WaitMessage no devuelve si hay entradas no leídas en la cola de mensajes después de que el subproceso haya llamado a una función para comprobar la cola. Esto se debe a que las funciones como PeekMessage, GetMessage, GetQueueStatus, WaitMessage, MsgWaitForMultipleObjects y MsgWaitForMultipleObjectsEx comprueban la cola y, a continuación, cambian la información de estado de la cola para que la entrada ya no se considere nueva. Una llamada posterior a WaitMessage no devolverá hasta que llegue la nueva entrada del tipo especificado. Se omite la entrada no leída existente (recibida antes de la última vez que el subproceso ha comprobado la cola).

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-window-l1-1-4 (introducido en Windows 10, versión 10.0.14393)

Consulte también

Conceptual

GetMessage

Mensajes y colas de mensajes

PeekMessage

Referencia