<refentry id="camel-CamelMimeMessage">
<refmeta>
<refentrytitle role="top_of_page" id="camel-CamelMimeMessage.top_of_page">CamelMimeMessage</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>CAMEL Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>CamelMimeMessage</refname>
<refpurpose></refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="camel-CamelMimeMessage.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
struct              <link linkend="CamelMimeMessage">CamelMimeMessage</link>;
#define             <link linkend="CAMEL-RECIPIENT-TYPE-TO:CAPS">CAMEL_RECIPIENT_TYPE_TO</link>
#define             <link linkend="CAMEL-RECIPIENT-TYPE-CC:CAPS">CAMEL_RECIPIENT_TYPE_CC</link>
#define             <link linkend="CAMEL-RECIPIENT-TYPE-BCC:CAPS">CAMEL_RECIPIENT_TYPE_BCC</link>
#define             <link linkend="CAMEL-RECIPIENT-TYPE-RESENT-TO:CAPS">CAMEL_RECIPIENT_TYPE_RESENT_TO</link>
#define             <link linkend="CAMEL-RECIPIENT-TYPE-RESENT-CC:CAPS">CAMEL_RECIPIENT_TYPE_RESENT_CC</link>
#define             <link linkend="CAMEL-RECIPIENT-TYPE-RESENT-BCC:CAPS">CAMEL_RECIPIENT_TYPE_RESENT_BCC</link>
#define             <link linkend="CAMEL-MESSAGE-DATE-CURRENT:CAPS">CAMEL_MESSAGE_DATE_CURRENT</link>
<link linkend="CamelMimeMessage">CamelMimeMessage</link>*   <link linkend="camel-mime-message-new">camel_mime_message_new</link>              (void);
<link linkend="void">void</link>                <link linkend="camel-mime-message-set-date">camel_mime_message_set_date</link>         (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         <link linkend="time-t">time_t</link> date,
                                                         <link linkend="int">int</link> offset);
<link linkend="time-t">time_t</link>              <link linkend="camel-mime-message-get-date">camel_mime_message_get_date</link>         (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         <link linkend="int">int</link> *offset);
<link linkend="time-t">time_t</link>              <link linkend="camel-mime-message-get-date-received">camel_mime_message_get_date_received</link>
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         <link linkend="int">int</link> *offset);
<link linkend="void">void</link>                <link linkend="camel-mime-message-set-message-id">camel_mime_message_set_message_id</link>   (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *message_id);
const <link linkend="char">char</link>*         <link linkend="camel-mime-message-get-message-id">camel_mime_message_get_message_id</link>   (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);
<link linkend="void">void</link>                <link linkend="camel-mime-message-set-reply-to">camel_mime_message_set_reply_to</link>     (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="CamelInternetAddress">CamelInternetAddress</link> *reply_to);
const <link linkend="CamelInternetAddress">CamelInternetAddress</link>* <link linkend="camel-mime-message-get-reply-to">camel_mime_message_get_reply_to</link>
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);
<link linkend="void">void</link>                <link linkend="camel-mime-message-set-subject">camel_mime_message_set_subject</link>      (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *subject);
const <link linkend="char">char</link>*         <link linkend="camel-mime-message-get-subject">camel_mime_message_get_subject</link>      (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);
<link linkend="void">void</link>                <link linkend="camel-mime-message-set-from">camel_mime_message_set_from</link>         (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="CamelInternetAddress">CamelInternetAddress</link> *from);
const <link linkend="CamelInternetAddress">CamelInternetAddress</link>* <link linkend="camel-mime-message-get-from">camel_mime_message_get_from</link> (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);
const <link linkend="CamelInternetAddress">CamelInternetAddress</link>* <link linkend="camel-mime-message-get-recipients">camel_mime_message_get_recipients</link>
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *type);
<link linkend="void">void</link>                <link linkend="camel-mime-message-set-recipients">camel_mime_message_set_recipients</link>   (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *type,
                                                         const <link linkend="CamelInternetAddress">CamelInternetAddress</link> *recipients);
<link linkend="void">void</link>                <link linkend="camel-mime-message-set-source">camel_mime_message_set_source</link>       (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *identity);
const <link linkend="char">char</link>*         <link linkend="camel-mime-message-get-source">camel_mime_message_get_source</link>       (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);
<link linkend="gboolean">gboolean</link>            <link linkend="camel-mime-message-has-8bit-parts">camel_mime_message_has_8bit_parts</link>   (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);
<link linkend="void">void</link>                <link linkend="camel-mime-message-set-best-encoding">camel_mime_message_set_best_encoding</link>
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         <link linkend="CamelBestencRequired">CamelBestencRequired</link> required,
                                                         <link linkend="CamelBestencEncoding">CamelBestencEncoding</link> enctype);
<link linkend="void">void</link>                <link linkend="camel-mime-message-encode-8bit-parts">camel_mime_message_encode_8bit_parts</link>
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);
<link linkend="CamelMimePart">CamelMimePart</link>*      <link linkend="camel-mime-message-get-part-by-content-id">camel_mime_message_get_part_by_content_id</link>
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *content_id);
<link linkend="char">char</link>*               <link linkend="camel-mime-message-build-mbox-from">camel_mime_message_build_mbox_from</link>  (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);
<link linkend="void">void</link>                <link linkend="camel-mime-message-dump">camel_mime_message_dump</link>             (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *msg,
                                                         <link linkend="int">int</link> body);
</synopsis>
</refsynopsisdiv>









<refsect1 id="camel-CamelMimeMessage.description" role="desc">
<title role="desc.title">Description</title>
<para>

</para>
</refsect1>

<refsect1 id="camel-CamelMimeMessage.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="CamelMimeMessage" role="struct">
<title>struct CamelMimeMessage</title>
<indexterm zone="CamelMimeMessage"><primary>CamelMimeMessage</primary></indexterm><programlisting>struct CamelMimeMessage {
	CamelMimePart parent_object;

	/* header fields */
	time_t date;
	int date_offset;	/* GMT offset */

	/* cached internal copy */
	time_t date_received;
	int date_received_offset;	/* GMT offset */

	char *subject;

	char *message_id;

	CamelInternetAddress *reply_to;
	CamelInternetAddress *from;

	GHashTable *recipients;	/* hash table of CamelInternetAddress's */
};
</programlisting>
<para>

</para></refsect2>
<refsect2 id="CAMEL-RECIPIENT-TYPE-TO:CAPS" role="macro">
<title>CAMEL_RECIPIENT_TYPE_TO</title>
<indexterm zone="CAMEL-RECIPIENT-TYPE-TO:CAPS"><primary>CAMEL_RECIPIENT_TYPE_TO</primary></indexterm><programlisting>#define CAMEL_RECIPIENT_TYPE_TO "To"
</programlisting>
<para>

</para></refsect2>
<refsect2 id="CAMEL-RECIPIENT-TYPE-CC:CAPS" role="macro">
<title>CAMEL_RECIPIENT_TYPE_CC</title>
<indexterm zone="CAMEL-RECIPIENT-TYPE-CC:CAPS"><primary>CAMEL_RECIPIENT_TYPE_CC</primary></indexterm><programlisting>#define CAMEL_RECIPIENT_TYPE_CC "Cc"
</programlisting>
<para>

</para></refsect2>
<refsect2 id="CAMEL-RECIPIENT-TYPE-BCC:CAPS" role="macro">
<title>CAMEL_RECIPIENT_TYPE_BCC</title>
<indexterm zone="CAMEL-RECIPIENT-TYPE-BCC:CAPS"><primary>CAMEL_RECIPIENT_TYPE_BCC</primary></indexterm><programlisting>#define CAMEL_RECIPIENT_TYPE_BCC "Bcc"
</programlisting>
<para>

</para></refsect2>
<refsect2 id="CAMEL-RECIPIENT-TYPE-RESENT-TO:CAPS" role="macro">
<title>CAMEL_RECIPIENT_TYPE_RESENT_TO</title>
<indexterm zone="CAMEL-RECIPIENT-TYPE-RESENT-TO:CAPS"><primary>CAMEL_RECIPIENT_TYPE_RESENT_TO</primary></indexterm><programlisting>#define CAMEL_RECIPIENT_TYPE_RESENT_TO "Resent-To"
</programlisting>
<para>

</para></refsect2>
<refsect2 id="CAMEL-RECIPIENT-TYPE-RESENT-CC:CAPS" role="macro">
<title>CAMEL_RECIPIENT_TYPE_RESENT_CC</title>
<indexterm zone="CAMEL-RECIPIENT-TYPE-RESENT-CC:CAPS"><primary>CAMEL_RECIPIENT_TYPE_RESENT_CC</primary></indexterm><programlisting>#define CAMEL_RECIPIENT_TYPE_RESENT_CC "Resent-Cc"
</programlisting>
<para>

</para></refsect2>
<refsect2 id="CAMEL-RECIPIENT-TYPE-RESENT-BCC:CAPS" role="macro">
<title>CAMEL_RECIPIENT_TYPE_RESENT_BCC</title>
<indexterm zone="CAMEL-RECIPIENT-TYPE-RESENT-BCC:CAPS"><primary>CAMEL_RECIPIENT_TYPE_RESENT_BCC</primary></indexterm><programlisting>#define CAMEL_RECIPIENT_TYPE_RESENT_BCC "Resent-Bcc"
</programlisting>
<para>

</para></refsect2>
<refsect2 id="CAMEL-MESSAGE-DATE-CURRENT:CAPS" role="macro">
<title>CAMEL_MESSAGE_DATE_CURRENT</title>
<indexterm zone="CAMEL-MESSAGE-DATE-CURRENT:CAPS"><primary>CAMEL_MESSAGE_DATE_CURRENT</primary></indexterm><programlisting>#define CAMEL_MESSAGE_DATE_CURRENT (~0)
</programlisting>
<para>

</para></refsect2>
<refsect2 id="camel-mime-message-new" role="function">
<title>camel_mime_message_new ()</title>
<indexterm zone="camel-mime-message-new"><primary>camel_mime_message_new</primary></indexterm><programlisting><link linkend="CamelMimeMessage">CamelMimeMessage</link>*   camel_mime_message_new              (void);</programlisting>
<para>
Create a new <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>a new <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-set-date" role="function">
<title>camel_mime_message_set_date ()</title>
<indexterm zone="camel-mime-message-set-date"><primary>camel_mime_message_set_date</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_set_date         (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         <link linkend="time-t">time_t</link> date,
                                                         <link linkend="int">int</link> offset);</programlisting>
<para>
Set the date on a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>date</parameter>&nbsp;:</term>
<listitem><simpara> a time_t date
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>offset</parameter>&nbsp;:</term>
<listitem><simpara> an offset from GMT
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-date" role="function">
<title>camel_mime_message_get_date ()</title>
<indexterm zone="camel-mime-message-get-date"><primary>camel_mime_message_get_date</primary></indexterm><programlisting><link linkend="time-t">time_t</link>              camel_mime_message_get_date         (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         <link linkend="int">int</link> *offset);</programlisting>
<para>
Get the date and GMT offset of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>offset</parameter>&nbsp;:</term>
<listitem><simpara> output for the GMT offset
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the date of the message
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-date-received" role="function">
<title>camel_mime_message_get_date_received ()</title>
<indexterm zone="camel-mime-message-get-date-received"><primary>camel_mime_message_get_date_received</primary></indexterm><programlisting><link linkend="time-t">time_t</link>              camel_mime_message_get_date_received
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         <link linkend="int">int</link> *offset);</programlisting>
<para>
Get the received date and GMT offset of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>offset</parameter>&nbsp;:</term>
<listitem><simpara> output for the GMT offset
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the received date of the message
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-set-message-id" role="function">
<title>camel_mime_message_set_message_id ()</title>
<indexterm zone="camel-mime-message-set-message-id"><primary>camel_mime_message_set_message_id</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_set_message_id   (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *message_id);</programlisting>
<para>
Set the message-id on a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>message_id</parameter>&nbsp;:</term>
<listitem><simpara> id of the message
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-message-id" role="function">
<title>camel_mime_message_get_message_id ()</title>
<indexterm zone="camel-mime-message-get-message-id"><primary>camel_mime_message_get_message_id</primary></indexterm><programlisting>const <link linkend="char">char</link>*         camel_mime_message_get_message_id   (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);</programlisting>
<para>
Get the message-id of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the message-id of a message
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-set-reply-to" role="function">
<title>camel_mime_message_set_reply_to ()</title>
<indexterm zone="camel-mime-message-set-reply-to"><primary>camel_mime_message_set_reply_to</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_set_reply_to     (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="CamelInternetAddress">CamelInternetAddress</link> *reply_to);</programlisting>
<para>
Set the Reply-To of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>reply_to</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelInternetAddress"><type>CamelInternetAddress</type></link> object
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-reply-to" role="function">
<title>camel_mime_message_get_reply_to ()</title>
<indexterm zone="camel-mime-message-get-reply-to"><primary>camel_mime_message_get_reply_to</primary></indexterm><programlisting>const <link linkend="CamelInternetAddress">CamelInternetAddress</link>* camel_mime_message_get_reply_to
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);</programlisting>
<para>
Get the Reply-To of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the Reply-Toa ddress of the message
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-set-subject" role="function">
<title>camel_mime_message_set_subject ()</title>
<indexterm zone="camel-mime-message-set-subject"><primary>camel_mime_message_set_subject</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_set_subject      (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *subject);</programlisting>
<para>
Set the subject text of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>subject</parameter>&nbsp;:</term>
<listitem><simpara> UTF-8 message subject
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-subject" role="function">
<title>camel_mime_message_get_subject ()</title>
<indexterm zone="camel-mime-message-get-subject"><primary>camel_mime_message_get_subject</primary></indexterm><programlisting>const <link linkend="char">char</link>*         camel_mime_message_get_subject      (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);</programlisting>
<para>
Get the UTF-8 subject text of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the message subject
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-set-from" role="function">
<title>camel_mime_message_set_from ()</title>
<indexterm zone="camel-mime-message-set-from"><primary>camel_mime_message_set_from</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_set_from         (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="CamelInternetAddress">CamelInternetAddress</link> *from);</programlisting>
<para>
Set the from address of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>from</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelInternetAddress"><type>CamelInternetAddress</type></link> object
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-from" role="function">
<title>camel_mime_message_get_from ()</title>
<indexterm zone="camel-mime-message-get-from"><primary>camel_mime_message_get_from</primary></indexterm><programlisting>const <link linkend="CamelInternetAddress">CamelInternetAddress</link>* camel_mime_message_get_from (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);</programlisting>
<para>
Get the from address of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the from address of the message
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-recipients" role="function">
<title>camel_mime_message_get_recipients ()</title>
<indexterm zone="camel-mime-message-get-recipients"><primary>camel_mime_message_get_recipients</primary></indexterm><programlisting>const <link linkend="CamelInternetAddress">CamelInternetAddress</link>* camel_mime_message_get_recipients
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *type);</programlisting>
<para>
Get the message recipients of a specified type.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&nbsp;:</term>
<listitem><simpara> recipient type
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the requested recipients
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-set-recipients" role="function">
<title>camel_mime_message_set_recipients ()</title>
<indexterm zone="camel-mime-message-set-recipients"><primary>camel_mime_message_set_recipients</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_set_recipients   (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *type,
                                                         const <link linkend="CamelInternetAddress">CamelInternetAddress</link> *recipients);</programlisting>
<para>
Set the recipients of a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&nbsp;:</term>
<listitem><simpara> recipient type (one of <link linkend="CAMEL-RECIPIENT-TYPE-TO:CAPS"><type>CAMEL_RECIPIENT_TYPE_TO</type></link>, <link linkend="CAMEL-RECIPIENT-TYPE-CC:CAPS"><type>CAMEL_RECIPIENT_TYPE_CC</type></link>, or <link linkend="CAMEL-RECIPIENT-TYPE-BCC:CAPS"><type>CAMEL_RECIPIENT_TYPE_BCC</type></link>)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recipients</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelInternetAddress"><type>CamelInternetAddress</type></link> with the recipient addresses set
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-set-source" role="function">
<title>camel_mime_message_set_source ()</title>
<indexterm zone="camel-mime-message-set-source"><primary>camel_mime_message_set_source</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_set_source       (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *identity);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>identity</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-source" role="function">
<title>camel_mime_message_get_source ()</title>
<indexterm zone="camel-mime-message-get-source"><primary>camel_mime_message_get_source</primary></indexterm><programlisting>const <link linkend="char">char</link>*         camel_mime_message_get_source       (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-has-8bit-parts" role="function">
<title>camel_mime_message_has_8bit_parts ()</title>
<indexterm zone="camel-mime-message-has-8bit-parts"><primary>camel_mime_message_has_8bit_parts</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            camel_mime_message_has_8bit_parts   (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);</programlisting>
<para>
Find out if a message contains 8bit or binary encoded parts.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>%TRUE if the message contains 8bit parts or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-set-best-encoding" role="function">
<title>camel_mime_message_set_best_encoding ()</title>
<indexterm zone="camel-mime-message-set-best-encoding"><primary>camel_mime_message_set_best_encoding</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_set_best_encoding
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         <link linkend="CamelBestencRequired">CamelBestencRequired</link> required,
                                                         <link linkend="CamelBestencEncoding">CamelBestencEncoding</link> enctype);</programlisting>
<para>
Re-encode all message parts to conform with the required encoding rules.
</para>
<para>
If <parameter>enctype</parameter> is <link linkend="CAMEL-BESTENC-7BIT:CAPS"><type>CAMEL_BESTENC_7BIT</type></link>, then all parts will be re-encoded into
one of the 7bit transfer encodings. If <parameter>enctype</parameter> is <link linkend="CAMEL-BESTENC-8bit"><type>CAMEL_BESTENC_8bit</type></link>, all
parts will be re-encoded to either a 7bit encoding or, if the part is 8bit
text, allowed to stay 8bit. If <parameter>enctype</parameter> is <link linkend="CAMEL-BESTENC-BINARY:CAPS"><type>CAMEL_BESTENC_BINARY</type></link>, then binary
parts will be encoded as binary and 8bit textual parts will be encoded as 8bit.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>required</parameter>&nbsp;:</term>
<listitem><simpara> a bitwise ORing of <link linkend="CAMEL-BESTENC-GET-ENCODING:CAPS"><type>CAMEL_BESTENC_GET_ENCODING</type></link> and <link linkend="CAMEL-BESTENC-GET-CHARSET:CAPS"><type>CAMEL_BESTENC_GET_CHARSET</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>enctype</parameter>&nbsp;:</term>
<listitem><simpara> an encoding to enforce
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-encode-8bit-parts" role="function">
<title>camel_mime_message_encode_8bit_parts ()</title>
<indexterm zone="camel-mime-message-encode-8bit-parts"><primary>camel_mime_message_encode_8bit_parts</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_encode_8bit_parts
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);</programlisting>
<para>
Encode all message parts to a suitable transfer encoding for transport (7bit clean).</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-get-part-by-content-id" role="function">
<title>camel_mime_message_get_part_by_content_id ()</title>
<indexterm zone="camel-mime-message-get-part-by-content-id"><primary>camel_mime_message_get_part_by_content_id</primary></indexterm><programlisting><link linkend="CamelMimePart">CamelMimePart</link>*      camel_mime_message_get_part_by_content_id
                                                        (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message,
                                                         const <link linkend="char">char</link> *content_id);</programlisting>
<para>
Get a MIME part by id from a message.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>content_id</parameter>&nbsp;:</term>
<listitem><simpara> content-id to search for
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>the MIME part with the requested id or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if not found
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-build-mbox-from" role="function">
<title>camel_mime_message_build_mbox_from ()</title>
<indexterm zone="camel-mime-message-build-mbox-from"><primary>camel_mime_message_build_mbox_from</primary></indexterm><programlisting><link linkend="char">char</link>*               camel_mime_message_build_mbox_from  (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *message);</programlisting>
<para>
Build an MBox from-line from <parameter>message</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="CamelMimeMessage"><type>CamelMimeMessage</type></link> object
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>an MBox from-line suitable for use in an mbox file
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="camel-mime-message-dump" role="function">
<title>camel_mime_message_dump ()</title>
<indexterm zone="camel-mime-message-dump"><primary>camel_mime_message_dump</primary></indexterm><programlisting><link linkend="void">void</link>                camel_mime_message_dump             (<link linkend="CamelMimeMessage">CamelMimeMessage</link> *msg,
                                                         <link linkend="int">int</link> body);</programlisting>
<para>
Dump information about the mime message to stdout.
</para>
<para>
If body is TRUE, then dump body content of the message as well (currently unimplemented).</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>msg</parameter>&nbsp;:</term>
<listitem><simpara> 
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>body</parameter>&nbsp;:</term>
<listitem><simpara> 
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
