Share via


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

Reference

CDynamicChain Class