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