Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function defines a new window message that is guaranteed to be unique throughout the system. The returned message value can be used when calling the SendMessageor PostMessagefunction.

Syntax 

UINT RegisterWindowMessage( 
  LPCTSTR  
lpString 
);

Parameters

lpString

Pointer to a null-terminated string that specifies the message to be registered.

Return Value

A message identifier in the range 0xC000 through 0xFFFF indicates that the message is successfully registered. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The RegisterWindowMessagefunction is typically used to register messages for communicating between two cooperating applications.

If two different applications register the same message string, the applications return the same message value. The message remains registered until the session ends.

Only use RegisterWindowMessagewhen more than one application must process the same message. For sending private messages within a window class, an application can use any integer in the range WM_USER through 0x7FFF. Messages in this range are private to a window class, not to an application. For example, predefined control classes such as BUTTON, EDIT, and LISTBOX may use values in this range.

Requirements

Header winuser.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also