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_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.
Adds to
The cmc_act_on function.
See Also