SMTPRelayServers Collection (Dundas Mailer Control 1.0)

Dundas

SMTPRelayServers Collection (Dundas Mailer Control 1.0)

This collection stores SMTPRelayServer objects, and determines the SMTP relay servers to be used when sending the email (if any). Note that it is 0-based.

Remarks

The SMTPRelayServers collection supports the following methods and properties:

  • Add(Name as string, [Port as long = 25, LocalHost as string = "local.com", User as string = "", Password as string = ""). Adds an SMTPRelayServer object to the collection.

  • Remove(Index). Removes a particular object from the collection.

  • Count (read-only property). The number of objects stored in the collection.

  • Item(Index). Used to retrieve a particular object from the collection.

  • Clear(). Removes all objects from the collection.

If the SMTPRelayServers collection is empty then the email message is sent directly to the destination server, so a DNS server is required to determine where the message is to be sent. However, if the SMTPRelayServers collection is not empty then the message is sent using the specified relay server, and the DNSServers collection is ignored since the relay server is responsible for determining where the message is being sent to. If both of these collections are empty then the DNS server to be used defaults to "A.ROOT-SERVERS.NET". If this fails "B.ROOT-SERVERS.NET" will be tried. If this too fails then "C.ROOT-SERVERS.NET" will be tried. If all of these fail then the mail operation will fail as well.

It is highly recommended that you specify at least one relay server. Using a relay increases the speed of the operation, and a relay will also attempt to send a message multiple times if it can not be sent with the first attempt. A Direct Send mail operation (performed when no SMTP servers have been specified) will only attempt to send the email one (1) time.

All mail send operations (including PostArticle) utilize this collection.

See Also: SMTPRelayServer Object | Add Method | Clear Method | Count Property | Item Method | Remove Method | DNSServers Collection