winuser.h


PostMessage

La función PostMessage coloca (postea) un mensaje en la cola de mensajes asociada con el proceso que creó la ventana especificada y después retorna sin esperar a que el mensaje sea procesado. Los menajes en la cola de mensajes son recuperados por llamadas a las funciones GetMessage o PeekMessage.

Sintaxis

BOOL PostMessage(
    HWND hwnd,      // manipulador de la ventana de destino
    UINT uMsg,      // mensaje a enviar
    WPARAM wParam,  // primer parámetro del mensaje
    LPARAM lParam   // segundo parámetro del mensaje
   ); 

Parámetros:

hwnd: identifica la ventana cuyo procedimiento de ventana recibirá el mensaje. Hay dos valores con significados especiales:

HWND_BROADCAST: el mensaje se envía a todas las ventanas de nivel superior en el sistema, incluyendo las deshabilitadas o invisibles sin dueño, ventanas superpuestas u ventanas pop-up; pero el mensaje no se envía a las ventanas hijas.

NULL: la función se comporta como una llamada a PostThreadMessage con el valor del identificador del proceso actual como parámetro dwThreadId.

uMsg: especifica el mensaje a enviar.

wParam: especifica información adicional específica para el mensaje.

lParam: especifica información adicional específica para el mensaje.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener información adicional sobre el motivo del error, hay que llamar a la función GetLastError.

Observaciones

Una aplicación de 32 bits no debe postear mensajes menores que WM_USER que contengan punteros.