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 dispatches a message to a window procedure. It is typically used to dispatch a message retrieved by the GetMessagefunction.

Syntax 

LONG  DispatchMessage( 
  const MSG* 
lpmsg 
);

Parameters

lpmsg

[in] Pointer to an MSGstructure that contains the message.

Return Value

The return value specifies the value returned by the window procedure. Although its meaning depends on the message being dispatched, the return value generally is ignored.

Remarks

The MSGstructure must contain valid message values. If the lpmsgparameter points to a WM_TIMERmessage and the lParamparameter of the WM_TIMER message is not NULL, lParampoints to a function that is called instead of the window procedure.

Requirements

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

See Also