Share via

DispatchMessage

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

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