CDynamicChain::CallChain

Article
12/01/2015

Directs the Windows message to another object's message map.

Syntax

      BOOL CallChain(
   DWORD dwChainID,
   HWND hWnd,
   UINT uMsg,
   WPARAM wParam,
   LPARAM lParam,
   LRESULT& lResult 
);

Parameters

dwChainID
[in] The unique identifier associated with the chained object and its message map.
hWnd
[in] The handle to the window receiving the message.
uMsg
[in] The message sent to the window.
wParam
[in] Additional message-specific information.
lParam
[in] Additional message-specific information.
lResult
[out] The result of the message processing.

Return Value

TRUE if the message is fully processed; otherwise, FALSE.

Remarks

For the window procedure to invoke CallChain, you must specify the CHAIN_MSG_MAP_DYNAMIC macro in your message map. For an example, see the CDynamicChain overview.

CallChain requires a previous call to SetChainEntry to associate the dwChainID value with an object and its message map.

Requirements

Header: atlwin.h

Share via