InternetMail.SendMessage Method (String, Int32, Int32)

Submit the specified message to a mail server for delivery.

Parameters

hostName

A string value which specifies the host name or IP address of the mail server that the message will be submitted to for delivery.

hostPort

An integer value which specifies the port number which should be used to establish a connection with the mail server. The default port number is 25 for the Simple Mail Transfer Protocol.

timeout

An integer value which specifies a timeout period in seconds. If the message cannot be submitted within the specified time period, the method will fail. The default timeout value for connections is 20 seconds.

Return Value

This method returns a boolean value. If the method succeeds, the return value is true. If the method fails, the return value is false. To get extended error information, check the value of the LastError property.

Remarks

The SendMessage method enables an application to send a formatted e-mail message using the current mail server. This provides a convenient one-step method of addressing and sending a message.

This method will cause the current thread to block until the message transfer completes, a timeout occurs or the transfer is canceled. During the transfer, the OnProgress event will fire periodically, enabling the application to update any user interface objects such as a progress bar.

The mail server that is specified must be configured to permit relaying messages, or the submission may fail. In most cases, the server will require that the client authenticate the session with a username and password. Alternatively, some mail servers require that you connect and authenticate with their POP3 service before the SMTP service will accept a message. Consult the documentation for your mail service provider for more information on the requirements for submitting messages for delivery.

See Also

InternetMail Class | SocketTools Namespace | InternetMail.SendMessage Overload List