SmtpConfiguration

Description

The SmtpConfiguration object contains all properties required for sending a Mail object via an SMTP server.

› Inherits:: Object

Overview

Properties

authenticationMethod
encryptionMode
password
port
senderHostname

Methods

Signals

Object.completed()

Enumerations

AuthMethod
EncryptionMode

Properties

authenticationMethod

This property holds the method to use when authenticating against the SMTP server.

This property was introduced in InCore 2.7.

› Type:: AuthMethod
› Default:: SmtpConfiguration.AuthNone
› Signal:: authenticationMethodChanged()
› Attributes:: Writable

encryptionMode

This property holds the encryption type to use when connection to the SMTP server. Encryption should only be disabled in special cases, i.e. when using an internal SMTP relay which does not require authentication. Otherwise username and password are sent unencrypted over the network.

This property was introduced in InCore 2.9.

› Type:: EncryptionMode
› Default:: SmtpConfiguration.EncryptTLS
› Signal:: encryptionModeChanged()
› Attributes:: Writable

password

This property holds the password used for authenticating against the SMTP server.

› Type:: String
› Signal:: passwordChanged()
› Attributes:: Writable

port

This property holds the TCP port of the SMTP server.

› Type:: SignedInteger
› Default:: 25
› Signal:: portChanged()
› Attributes:: Writable

senderHostname

This property holds the hostname of the sender (i.e. the sending device). It is sent to the SMTP for informational purposes but may be used for anti-spam mechanisms as well. For this reason it’s advisable to set a valid and publicly resolvable hostname when talking to public SMTP servers.

› Type:: String
› Signal:: senderHostnameChanged()
› Attributes:: Writable

server

This property holds the hostname of the SMTP server to use for sending mails.

› Type:: String
› Signal:: serverChanged()
› Attributes:: Writable

username

This property holds the username used for authenticating against the SMTP server.

› Type:: String
› Signal:: usernameChanged()
› Attributes:: Writable

Enumerations

AuthMethod

This enumeration describes supported methods for authenticating against an SMTP server.

This enumeration was introduced in InCore 2.7.

Name	Value	Description
`SmtpConfiguration.AuthNone`	`0`
`SmtpConfiguration.AuthPlain`	`1`
`SmtpConfiguration.AuthLogin`	`2`
`SmtpConfiguration.AuthCramMd5`	`3`

EncryptionMode

Name	Value	Description
`SmtpConfiguration.EncryptNone`	`0`
`SmtpConfiguration.EncryptSSL`	`1`
`SmtpConfiguration.EncryptTLS`	`2`

Example

See Mail example on how to use SmtpConfiguration.