CMC_X_COM_SAVE_MESSAGE

CMC_X_COM_SAVE_MESSAGE is a CMC extension that saves a message (that is, a CMC_message structure) to the receive folder (the Inbox).

Quick Info

Header file:

XCMCEXT.H

 

Input Usage

item_data

Zero.

item_reference

Pointer to the CMC_message1KO2ZRW structure to save to the receive folder. To indicate that an unsent message has not been sent, the CMC implementation sets the CMC_MSG_UNSENT flag in the message_flags member of the CMC_message structure. To indicate that the operation to be performed (save to receive folder) is contained in a CMC_X_COM_SAVE_MESSAGE extension, the cmc_act_on21BRNR0 function s operation parameter must be set to the CMC_ACT_ON_EXTENDED flag.

extension_flags

All flags used with the CMC_extensionWY87UR structure are valid. No further flags are defined. To indicate that the CMC implementation should carry out a save action rather than a deletion, the flag CMC_EXT_REQUIRED must be set in the extension_flags member.

 

Output Usage

item_data

Unchanged.

item_reference

Pointer to the message reference of the message that was saved to the receive folder (the Inbox). The client application must free the message reference using the cmc_free1RMW6IO function.

extension_flags

If cmc_act_on has successfully saved the message and returned the message reference, the CMC_EXT_OUTPUT flag is set.

 

Adds to

The cmc_act_on21BRNR0 function.

See Also

cmc_act_on, CMC_extension, CMC_message, CMC_message_reference