|  |  |  | Evolution-Data-Server Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
| ESourceMailSubmissionESourceMailSubmission — ESource extension for submitting emails | 
#include <libedataserver/libedataserver.h> #define E_SOURCE_EXTENSION_MAIL_SUBMISSION struct ESourceMailSubmission; struct ESourceMailSubmissionClass; const gchar * e_source_mail_submission_get_sent_folder (ESourceMailSubmission *extension); gchar * e_source_mail_submission_dup_sent_folder (ESourceMailSubmission *extension); void e_source_mail_submission_set_sent_folder (ESourceMailSubmission *extension,const gchar *sent_folder); const gchar * e_source_mail_submission_get_transport_uid (ESourceMailSubmission *extension); gchar * e_source_mail_submission_dup_transport_uid (ESourceMailSubmission *extension); void e_source_mail_submission_set_transport_uid (ESourceMailSubmission *extension,const gchar *transport_uid); gboolean e_source_mail_submission_get_replies_to_origin_folder (ESourceMailSubmission *extension); void e_source_mail_submission_set_replies_to_origin_folder (ESourceMailSubmission *extension,gboolean replies_to_origin_folder);
The ESourceMailSubmission extension tracks settings to be applied when submitting a mail message for delivery.
Access the extension as follows:
| 1 2 3 4 5 | #include <libedataserver/libedataserver.h> ESourceMailSubmission *extension; extension = e_source_get_extension (source, E_SOURCE_EXTENSION_MAIL_SUBMISSION); | 
#define E_SOURCE_EXTENSION_MAIL_SUBMISSION "Mail Submission"
Pass this extension name to e_source_get_extension() to access
ESourceMailSubmission.  This is also used as a group name in key files.
Since 3.6
struct ESourceMailSubmission {
	ESourceExtension parent;
	ESourceMailSubmissionPrivate *priv;
};
Contains only private data that should be read and manipulated using the function below.
Since 3.6
struct ESourceMailSubmissionClass {
	ESourceExtensionClass parent_class;
};
const gchar *       e_source_mail_submission_get_sent_folder
                                                        (ESourceMailSubmission *extension);
Returns a string identifying the preferred folder for sent messages. The format of the identifier string is defined by the client application.
| 
 | an ESourceMailSubmission | 
| Returns : | an identifier for the preferred sent folder | 
Since 3.6
gchar *             e_source_mail_submission_dup_sent_folder
                                                        (ESourceMailSubmission *extension);
Thread-safe variation of e_source_mail_submission_get_sent_folder().
Use this function when accessing extension from multiple threads.
The returned string should be freed with g_free() when no longer needed.
| 
 | an ESourceMailSubmission | 
| Returns : | a newly-allocated copy of "sent-folder" | 
Since 3.6
void e_source_mail_submission_set_sent_folder (ESourceMailSubmission *extension,const gchar *sent_folder);
Sets the preferred folder for sent messages by an identifier string. The format of the identifier string is defined by the client application.
The internal copy of sent_folder is automatically stripped of leading
and trailing whitespace.  If the resulting string is empty, NULL is set
instead.
| 
 | an ESourceMailSubmission | 
| 
 | an identifier for the preferred sent folder,
or NULL. [allow-none] | 
Since 3.6
const gchar *       e_source_mail_submission_get_transport_uid
                                                        (ESourceMailSubmission *extension);
Returns the "uid" of the ESource that describes the mail transport to be used for outgoing messages.
| 
 | an ESourceMailSubmission | 
| Returns : | the mail transport "uid" | 
Since 3.6
gchar *             e_source_mail_submission_dup_transport_uid
                                                        (ESourceMailSubmission *extension);
Thread-safe variation of e_source_mail_submission_get_transport_uid().
Use this function when accessing extension from multiple threads.
The returned string should be freed with g_free() when no longer needed.
| 
 | an ESourceMailSubmission | 
| Returns : | a newly-allocated copy of "transport-uid" | 
Since 3.6
void e_source_mail_submission_set_transport_uid (ESourceMailSubmission *extension,const gchar *transport_uid);
Sets the "uid" of the ESource that describes the mail transport to be used for outgoing messages.
| 
 | an ESourceMailSubmission | 
| 
 | the mail transport "uid", or NULL. [allow-none] | 
Since 3.6
gboolean            e_source_mail_submission_get_replies_to_origin_folder
                                                        (ESourceMailSubmission *extension);
Returns whether save replies in the folder of the message being replied to, instead of the Sent folder.
| 
 | an ESourceMailSubmission | 
| Returns : | whether save replies in the folder of the message being replied to | 
Since 3.8
void e_source_mail_submission_set_replies_to_origin_folder (ESourceMailSubmission *extension,gboolean replies_to_origin_folder);
Sets whether save replies in the folder of the message being replied to, instead of the Sent folder.
| 
 | an ESourceMailSubmission | 
| 
 | new value | 
Since 3.8