CDynamicChain::SetChainEntry

Article
12/01/2015

Adds the specified message map to the collection.

Syntax

      BOOL SetChainEntry(
   DWORD dwChainID,
   CMessageMap* pObject,
   DWORD dwMsgMapID = 0 
);

Parameters

dwChainID
[in] The unique identifier associated with the chained object and its message map.
pObject
[in] A pointer to the chained object declaring the message map. This object must derive from CMessageMap.
dwMsgMapID
[in] The identifier of the message map in the chained object. The default value is 0, which identifies the default message map declared with BEGIN_MSG_MAP. To specify an alternate message map declared with ALT_MSG_MAP(msgMapID), pass msgMapID.

Return Value

TRUE if the message map is successfully added to the collection. Otherwise, FALSE.

Remarks

If the dwChainID value already exists in the collection, its associated object and message map are replaced by pObject and dwMsgMapID, respectively. Otherwise, a new entry is added.

Requirements

Header: atlwin.h