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_message 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_on function's operation parameter must be set to the CMC_ACT_ON_EXTENDED flag.
extension_flags
All flags used with the CMC_extension 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_free function.
extension_flags
If cmc_act_on has successfully saved the message and returned the message reference, the CMC_EXT_OUTPUT flag is set.