DispatchMessage
This function dispatches a message to a window procedure. It is typically used to dispatch a message retrieved by the GetMessage function.
LONG DispatchMessage(
const MSG *lpmsg );
Parameters
- lpmsg
[in] Long pointer to an MSG structure that contains the message.
Return Values
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
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 1.0 and later | Winuser.h | Msgque.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
GetMessage, MSG, PeekMessage, PostMessage, TranslateMessage
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.