DispatchMessage
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 GetMessage function.
Syntax
LONG DispatchMessage(
const MSG* lpmsg
);
Parameters
- lpmsg
[in] Pointer to an MSG structure 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 MSG structure must contain valid message values. If the lpmsg parameter points to a WM_TIMER message and the lParam parameter of the WM_TIMER message is not NULL, lParam points 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
Reference
Message Queue Functions
GetMessage
PeekMessage
PostMessage
TranslateMessage
MSG