SocketTools .NET Edition

PopClient.SendMessage Method (String)

Submits a message to the mail server for delivery.

[Visual Basic]
Overloads Public Function SendMessage( _
   ByVal buffer As String _
) As Boolean
[C#]
public bool SendMessage(
   string buffer
);

Parameters

buffer
A string which contains the message to be submitted for delivery.

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 submits a message to the mail server for delivery. The message format must comply with the RFC 822 standard, with the header and body separated by a blank line, and each line terminated with carriage-return/linefeed characters.

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.

Note that this method requires that the server support the XTND XMIT command. Although using this method to send mail has the advantage that the sender is authenticated (because the user must first login to the server), it is not widely supported. For general purpose mail delivery service, it is recommended that an application use the Simple Mail Transfer Protocol (SMTP).

See Also

PopClient Class | SocketTools Namespace | PopClient.SendMessage Overload List