camel_network_settings_get_auth_mechanism ()

const gchar *
camel_network_settings_get_auth_mechanism
                               (CamelNetworkSettings *settings);

Returns the mechanism name used to authenticate to a network service. Often this refers to a SASL mechanism such as "LOGIN" or "GSSAPI".

Since 3.4

camel_network_settings_dup_auth_mechanism ()

gchar *
camel_network_settings_dup_auth_mechanism
                               (CamelNetworkSettings *settings);

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

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

Since 3.4

camel_network_settings_set_auth_mechanism ()

void
camel_network_settings_set_auth_mechanism
                               (CamelNetworkSettings *settings,
                                const gchar *auth_mechanism);

Sets the mechanism name used to authenticate to a network service. Often this refers to a SASL mechanism such as "LOGIN" or "GSSAPI". The “auth-mechanism” property is automatically stripped of leading and trailing whitespace.

Since 3.4

camel_network_settings_get_host ()

const gchar *
camel_network_settings_get_host (CamelNetworkSettings *settings);

Returns the host name used to authenticate to a network service.

Since 3.4

camel_network_settings_dup_host ()

gchar *
camel_network_settings_dup_host (CamelNetworkSettings *settings);

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

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

Since 3.4

camel_network_settings_set_host ()

void
camel_network_settings_set_host (CamelNetworkSettings *settings,
                                 const gchar *host);

Sets the host name used to authenticate to a network service. The “host” property is automatically stripped of leading and trailing whitespace.

Since 3.4

camel_network_settings_get_port ()

guint16
camel_network_settings_get_port (CamelNetworkSettings *settings);

Returns the port number used to authenticate to a network service.

Since 3.4

camel_network_settings_set_port ()

void
camel_network_settings_set_port (CamelNetworkSettings *settings,
                                 guint16 port);

Sets the port number used to authenticate to a network service.

Since 3.4

camel_network_settings_get_security_method ()

CamelNetworkSecurityMethod
camel_network_settings_get_security_method
                               (CamelNetworkSettings *settings);

Returns the method used to establish a secure (or unsecure) network connection.

Since 3.2

camel_network_settings_set_security_method ()

void
camel_network_settings_set_security_method
                               (CamelNetworkSettings *settings,
                                CamelNetworkSecurityMethod method);

Sets the method used to establish a secure (or unsecure) network connection. Note that changing this setting has no effect on an already-established network connection.

Since 3.2

camel_network_settings_get_user ()

const gchar *
camel_network_settings_get_user (CamelNetworkSettings *settings);

Returns the user name used to authenticate to a network service.

Since 3.4

camel_network_settings_dup_user ()

gchar *
camel_network_settings_dup_user (CamelNetworkSettings *settings);

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

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

Since 3.4

camel_network_settings_set_user ()

void
camel_network_settings_set_user (CamelNetworkSettings *settings,
                                 const gchar *user);

Sets the user name used to authenticate to a network service. The “user” property is automatically stripped of leading and trailing whitespace.

Since 3.4

camel_network_settings_dup_host_ensure_ascii ()

gchar *
camel_network_settings_dup_host_ensure_ascii
                               (CamelNetworkSettings *settings);

Just like camel_network_settings_dup_host(), only makes sure that the returned host name will be converted into its ASCII form in case of IDNA value.

Since 3.16

CamelNetworkSettings

typedef struct _CamelNetworkSettings CamelNetworkSettings;

Since 3.2

enum CamelNetworkSecurityMethod

Methods for establishing an encrypted (or unencrypted) network connection.

Since 3.2

The “auth-mechanism” property

  “auth-mechanism”           gchar *

Authentication mechanism name.

Flags: Read / Write / Construct

Default value: NULL

The “host” property

  “host”                     gchar *

Host name for the network service.

Flags: Read / Write / Construct

Default value: ""

The “port” property

  “port”                     guint

Port number for the network service.

Flags: Read / Write / Construct

Allowed values: <= 65535

Default value: 0

The “security-method” property

  “security-method”          CamelNetworkSecurityMethod

Method used to establish a network connection.

Flags: Read / Write / Construct

Default value: CAMEL_NETWORK_SECURITY_METHOD_STARTTLS_ON_STANDARD_PORT

The “user” property

  “user”                     gchar *

User name for the network account.

Flags: Read / Write / Construct

Default value: "abuild"