CDynamicChain::CallChain

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

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

See Also

Concepts

CDynamicChain Class

CDynamicChain Members