winuser.h

Función RegisterWindowMessage

Define un nuevo mensaje de ventana que se garantiza que es único en todo el sistema. El valor del mensaje puede ser usado cuando se envían mensajes (send o post).

Sintaxis

UINT RegisterWindowMessage(
  LPCSTR lpString
);

Parámetros

lpString: el mensaje a registrar.

Valor de retorno

Si el mensaje fue registrado con éxito, el valor de retorno es un identificador de mensaje en el rango entre 0xC000 y 0xFFFF.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, usar la función GetLastError.

Observaciones

La función RegisterWindowMessage se usa normalmente para registrar mensajes para la comunicación entre dos aplicaciones que cooperan.

Si dos aplicaciones diferentes registran la misma cadena de mensaje, las aplicaciones reciben el mismo valor de mensaje. El mensaje se mantiene registrado hasta qua la sesión termine.

Usar RegisterWindowMessage solo cuando más de una aplicación deba procesar el mismo mensaje. Para enviar mensajes privados dentro de una clase de ventana, las aplicaciones pueden usar cualquier entrero en el rango entre WM_USER y 0x7FFF. (Los mensaje en ese rango son privados para la clase de ventana, no para la aplicación. Por ejemplo, las clases de controles predefinidos como BUTTON, EDIT, LISTBOX y COMBOBOX pueden utilizar valores en este rango.)

Nota

El fichero de cabecera winuser.h define RegisterWindowMessage como un alias que selecciona la versión ANSI o Unicode de esta función dependiendo de la definición de la constante del preprocesador UNICODE. El uso del alias neutral mezclado con los no neutrales pueden producir desajustes que provoquen errores de compilación o de ejecución.