Función DispatchMessageW (winuser.h)

Artículo
11/20/2024

Envía un mensaje a un procedimiento de ventana. Normalmente se usa para enviar un mensaje recuperado por la función GetMessage.

Sintaxis

LRESULT DispatchMessageW(
  [in] const MSG *lpMsg
);

Parámetros

[in] lpMsg

Tipo: const MSG*

Puntero a una estructura que contiene el mensaje.

Valor devuelto

Tipo: LRESULT

El valor devuelto especifica el valor devuelto por el procedimiento de ventana. Aunque su significado depende del mensaje que se envía, generalmente se omite el valor devuelto.

Observaciones

La estructura de msg debe contener valores de mensaje válidos. Si el parámetro lpmsg apunta a un mensaje WM_TIMER y el parámetro lParam del mensaje de WM_TIMER no es NULL, lParam apunta a una función a la que se llama en lugar del procedimiento de ventana.

Tenga en cuenta que la aplicación es responsable de recuperar y enviar mensajes de entrada al cuadro de diálogo. La mayoría de las aplicaciones usan el bucle de mensajes principal para esto. Sin embargo, para permitir que el usuario se mueva a y seleccione controles mediante el teclado, la aplicación debe llamar a IsDialogMessage. Para obtener más información, vea interfaz de teclado del cuadro de diálogo.

Ejemplos

Para obtener un ejemplo, vea Crear un bucle de mensajes.

Nota

El encabezado winuser.h define DispatchMessage como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll
conjunto de API de	ext-ms-win-ntuser-message-l1-1-0 (introducido en Windows 8)