JVCL Help:TJvMail.SaveMail

From Project JEDI Wiki
Jump to navigationJump to search
JEDI Visual Component Library Help

Search in JVCL Help

 
Search in all projects
 

Summary

Saves a message into the message store.


Pascal

 functionSaveMail(constMessageID: string): string;


Parameters

Parameters Description
const MessageID: string Specifies either the message identifier to be replaced by the save operation or an empty string, indicating that a new message is to be created.


Description

Call SaveMail to save a message, optionally replacing an existing message. Before calling SaveMail, use the FindFirstMail and FindNextMail functions to verify that the message to be saved is the one you want saved. The elements of the message identified by the MessageID parameter are replaced by the elements specified by the properties Recipient, BlindCopy, CarbonCopy, Subject, Body and Attachment. If MessageID is an empty string, a new message is created. All replaced messages are saved in their appropriate folders. New messages are saved in the folder appropriate for incoming messages of that class.
Not all messaging systems support storing messages. If the underlying messaging system does not support message storage, an EJclMapiError exception is raised.
Because message identifiers are system-specific and opaque and can be invalidated at any time, SaveMail considers a message identifier to be valid only for the current Simple MAPI session. SaveMail handles invalid message identifiers by raising an EJclMapiError exception.


See Also

TJvMail.LogonOptions


About

Contribute to this help topic

This documentation wiki is based on the collaborative effort of Project JEDI users. Your edits are welcome in order to improve documentation quality: edit this page