g_mime_message_new ()

GMimeMessage *
g_mime_message_new (gboolean pretty_headers);

If pretty_headers is TRUE, then the standard rfc822 headers are initialized so as to put headers in a nice friendly order. This is strictly a cosmetic thing, so if you are unsure, it is safe to say no (FALSE).

g_mime_message_get_sender ()

InternetAddressList *
g_mime_message_get_sender (GMimeMessage *message);

Gets the parsed list of addresses in the Sender header.

g_mime_message_get_from ()

InternetAddressList *
g_mime_message_get_from (GMimeMessage *message);

Gets the parsed list of addresses in the From header.

g_mime_message_get_reply_to ()

InternetAddressList *
g_mime_message_get_reply_to (GMimeMessage *message);

Gets the parsed list of addresses in the Reply-To header.

g_mime_message_get_to ()

InternetAddressList *
g_mime_message_get_to (GMimeMessage *message);

Gets combined list of parsed addresses in the To header(s).

g_mime_message_get_cc ()

InternetAddressList *
g_mime_message_get_cc (GMimeMessage *message);

Gets combined list of parsed addresses in the Cc header(s).

g_mime_message_get_bcc ()

InternetAddressList *
g_mime_message_get_bcc (GMimeMessage *message);

Gets combined list of parsed addresses in the Bcc header(s).

g_mime_message_add_mailbox ()

void
g_mime_message_add_mailbox (GMimeMessage *message,
                            GMimeAddressType type,
                            const char *name,
                            const char *addr);

Add a mailbox of a chosen type to the MIME message.

Note: The name (and addr ) strings should be in UTF-8.

g_mime_message_get_addresses ()

InternetAddressList *
g_mime_message_get_addresses (GMimeMessage *message,
                              GMimeAddressType type);

Gets a list of addresses of the specified type from the message .

g_mime_message_get_all_recipients ()

InternetAddressList *
g_mime_message_get_all_recipients (GMimeMessage *message);

Gets the complete list of recipients for message .

g_mime_message_set_subject ()

void
g_mime_message_set_subject (GMimeMessage *message,
                            const char *subject,
                            const char *charset);

Set the subject of a message .

Note: The subject string should be in UTF-8.

g_mime_message_get_subject ()

const char *
g_mime_message_get_subject (GMimeMessage *message);

Gets the subject of the message .

g_mime_message_set_date ()

void
g_mime_message_set_date (GMimeMessage *message,
                         GDateTime *date);

Sets the Date header on a MIME Message.

g_mime_message_get_date ()

GDateTime *
g_mime_message_get_date (GMimeMessage *message);

Gets the parsed date and time value from the Date header.

g_mime_message_set_message_id ()

void
g_mime_message_set_message_id (GMimeMessage *message,
                               const char *message_id);

Set the Message-Id on a message.

g_mime_message_get_message_id ()

const char *
g_mime_message_get_message_id (GMimeMessage *message);

Gets the Message-Id header of message .

g_mime_message_set_mime_part ()

void
g_mime_message_set_mime_part (GMimeMessage *message,
                              GMimeObject *mime_part);

Set the root-level MIME part of the message.

g_mime_message_get_mime_part ()

GMimeObject *
g_mime_message_get_mime_part (GMimeMessage *message);

Gets the toplevel MIME part contained within message .

g_mime_message_foreach ()

void
g_mime_message_foreach (GMimeMessage *message,
                        GMimeObjectForeachFunc callback,
                        gpointer user_data);

Recursively calls callback on each of the mime parts in the mime message.

g_mime_message_get_body ()

GMimeObject *
g_mime_message_get_body (GMimeMessage *message);

Attempts to identify the MIME part containing the body of the message.

g_mime_message_get_autocrypt_header ()

GMimeAutocryptHeader *
g_mime_message_get_autocrypt_header (GMimeMessage *message,
                                     GDateTime *now);

Creates a new GMimeAutocryptHeader based on the relevant Autocrypt header associated with the sender of an e-mail message.

If the message has no sender in the From: field, or has more than one sender, then this function will return NULL. Autocrypt should ignore the message entirely.

If there is one sender, but no single Autocrypt header is found that matches that e-mail address, a GMimeAutocryptHeader will be returned for the sender, but it will be incomplete (see g_mime_autocrypt_header_is_complete).

Note that the following types of Autocrypt headers will not be returned by this function:

The returned Autocrypt header will have its effective_date set to the earliest of either:

g_mime_message_get_autocrypt_gossip_headers_from_inner_part ()

GMimeAutocryptHeaderList *
g_mime_message_get_autocrypt_gossip_headers_from_inner_part
                               (GMimeMessage *message,
                                GDateTime *now,
                                GMimeObject *inner_part);

Creates a new GMimeAutocryptHeaderList of relevant headers of the given type based on the recipient(s) of an e-mail message.

You must pass the decrypted inner part of the message to this function, since Autocrypt-Gossip headers are only stored within the encrypted layer.

If you don't already have the decrypted inner part available to you, you probably want to use g_mime_message_get_autocrypt_gossip_headers instead.

Each header in the returned list will:

If no Autocrypt header is found for a recipient, no GMimeAutocryptHeader will be in the list associated with that e-mail address.

Note that the following types of Autocrypt headers will not be returned by this function:

On error (e.g. if this version of GMime cannot handle the requested Autocrypt type, or if a parameter is missing or malformed), returns NULL

The returned Autocrypt headers will have their effective_date set to the earliest of either:

g_mime_message_get_autocrypt_gossip_headers ()

GMimeAutocryptHeaderList *
g_mime_message_get_autocrypt_gossip_headers
                               (GMimeMessage *message,
                                GDateTime *now,
                                GMimeDecryptFlags flags,
                                const char *session_key,
                                GError **err);

Creates a new GMimeAutocryptHeaderList of relevant headers of the given type based on the recipient(s) of an e-mail message.

Returns the same object as g_mime_message_get_autocrypt_gossip_headers_with_inner_part , but handles decryption and cleanup automatically.

flags and session_key are passed through to g_mime_multipart_encrypted_decrypt, as needed.

If the message is not actually an encrypted message, returns NULL: it should be ignored for purposes of evaluating gossip.

If decryption fails, returns NULL. In this case, an exception will be set on err to provide information about the decryption failure.

enum GMimeAddressType

An address type.

struct GMimeMessage

struct GMimeMessage;

A MIME Message object.