Función WaitMessage (winuser.h)
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
Referencia