ESourceMailAccount

ESourceMailAccount — ESource extension for an email account

Synopsis

#include <libedataserver/libedataserver.h>

struct              ESourceMailAccount;
#define             E_SOURCE_EXTENSION_MAIL_ACCOUNT
const gchar *       e_source_mail_account_get_identity_uid
                                                        (ESourceMailAccount *extension);
gchar *             e_source_mail_account_dup_identity_uid
                                                        (ESourceMailAccount *extension);
void                e_source_mail_account_set_identity_uid
                                                        (ESourceMailAccount *extension,
                                                         const gchar *identity_uid);

Object Hierarchy

  GObject
   +----ESourceExtension
         +----ESourceBackend
               +----ESourceMailAccount

Properties

  "identity-uid"             gchar*                : Read / Write / Construct

Description

The ESourceMailAccount extension identifies the ESource as a mail account and also links to a default "mail identity" to use. See ESourceMailIdentity for more information about identities.

Access the extension as follows:

1
2
3
4
5
#include <libedataserver/libedataserver.h>

ESourceMailAccount *extension;

extension = e_source_get_extension (source, E_SOURCE_EXTENSION_MAIL_ACCOUNT);

Details

struct ESourceMailAccount

struct ESourceMailAccount;

Contains only private data that should be read and manipulated using the functions below.

Since 3.6


E_SOURCE_EXTENSION_MAIL_ACCOUNT

#define E_SOURCE_EXTENSION_MAIL_ACCOUNT "Mail Account"

Pass this extension name to e_source_get_extension() to access ESourceMailAccount. This is also used as a group name in key files.

Since 3.6


e_source_mail_account_get_identity_uid ()

const gchar *       e_source_mail_account_get_identity_uid
                                                        (ESourceMailAccount *extension);

Returns the "uid" of the ESource that describes the mail identity to be used for this account.

extension :

an ESourceMailAccount

Returns :

the mail identity "uid"

Since 3.6


e_source_mail_account_dup_identity_uid ()

gchar *             e_source_mail_account_dup_identity_uid
                                                        (ESourceMailAccount *extension);

Thread-safe variation of e_source_mail_account_get_identity_uid(). Use this function when accessing extension from multiple threads.

The returned string should be freed with g_free() when no longer needed.

extension :

an ESourceMailAccount

Returns :

a newly-allocated copy of "identity-uid"

Since 3.6


e_source_mail_account_set_identity_uid ()

void                e_source_mail_account_set_identity_uid
                                                        (ESourceMailAccount *extension,
                                                         const gchar *identity_uid);

Sets the "uid" of the ESource that describes the mail identity to be used for this account.

extension :

an ESourceMailAccount

identity_uid :

the mail identity "uid", or NULL. [allow-none]

Since 3.6

Property Details

The "identity-uid" property

  "identity-uid"             gchar*                : Read / Write / Construct

ESource UID of a Mail Identity.

Default value: "self"