IOleInPlaceSiteWindowless::OnDefWindowMessage

Invokes the default processing for all messages passed to an object.

HRESULT OnDefWindowMessage(
  UINT msg,           //Message Identifier as provided by Windows
  WPARAM wParam,      //Message parameter as provided by Windows
  LPARAM lParam,      //Message parameter as provided by Windows
  LRESULT* plResult   //Pointer to message result code
);
 

Parameters

msg
[in] Identifier for the window message provided to the container by Windows.
wParam
[in] Parameter for the window message provided to the container by Windows.
lParam
[in] Parameter for the window message provided to the container by Windows.
plResult
[out] Pointer to result code for the window message as defined in the Windows API.

Return Values

S_OK
The container's default processing for the window message was successfully invoked.
S_FALSE
The container's default processing for the window message was not invoked. See Note to Implementers below.

Remarks

A windowless object can explicitly invoke the default processing for a window message by calling this method. A container dispatches window messages to its windowless objects by calling IOleInPlaceObjectWindowless::OnWindowMessage. The object usually returns S_FALSE to indicate that it did not process the message. Then, the container can perform the default behavior for the message by calling the Windows API function DefWindowProc.

Instead, the object can call this method on the container's site object to explicitly invoke the default processing. Then, the object can take action on its own if the container does not handle the message.

Note to Implementers

The container must pass the following window messages to its default window procedure (the DefWindowProc Windows API function) and return S_OK. Note that *plResult should contain the value returned by DefWindowProc.

WM_MOUSEMOVE WM_DEADCHAR
WM_XBUTTONxxx WM_SYSKEYUP
WM_KEYDOWN WM_SYSCHAR
WM_KEYUP WM_SYSDEADCHAR
WM_CHAR WM_IMExxx

The container can either process the window messages as its own and return S_OK or not do anything and return S_FALSE.

WM_SETCURSOR
WM_CONTEXTMENU
WM_HELP

If the container returns S_FALSE, the object can take action to process the window message on its own.

QuickInfo

  Windows NT: Use version 4.0 or later. New for OC96.
  Windows: Use Windows 95 or later. New for OC96.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.

See Also

IOleInPlaceObjectWindowless::OnWindowMessage