Progress Event

Description

Fires when a method has completed, the server has sent a reply, or progress information is available.

Syntax

Visual Basic
Public Event Progress( _ ByVal Method As SmtpMethodConstants, _ ByVal Status As SmtpStatusConstants, _ ByVal Reply As String, _ ByVal Count As Long, _ ByVal Size As Long _ )

Visual Basic

Public Event Progress( _
   ByVal Method As SmtpMethodConstants, _
   ByVal Status As SmtpStatusConstants, _
   ByVal Reply As String, _
   ByVal Count As Long, _
   ByVal Size As Long _
)

Parameters

Method

Value	Description
smtpCommand	Command, CommandEx Methods
smtpLogin	Login method
smtpLogout	Logout method
smtpQuickSend	QuickSend method
smtpReset	Reset method
smtpSend	Send method

Method that the event pertains to.

Status

Value	Description
smtpBad	Server has responded with a negative status indicating an error condition.
smtpCapabilities	Capabilities is updated.
smtpFrom	Server has responded positive to "MAIL FROM:" during the execution of the Send or QuickSend method.
smtpOk	Method has completed with a positive status indicating successful operation.
smtpSending	Indicates progress during the transmission of a message. Useful for percentage indication on a status display.
smtpTo	Server has responded positive to "RCPT TO:" during the execution of the Send or QuickSend method.

Reply

Status of the method.

Count

Number of bytes of the message sent so far when Status is smtpSending. The value is between 0 and Size.

Size

Size of the message when Status is smtpSending. This value is constant during a transfer.

Remarks

When a method is called, it causes Progress to fire to indicate progress, status, or completion information, such that:

Method indicates the method used
Status provides success / failure information
Reply provides the server reply
Count and Size are used to update the progress of a Send or QuickSend operation when Status = smtpSending (at other times these parameters are 0).

Use the Trace method to gather protocol-level data if the Reply parameter is inadequate.

Reply normally begins with one of the following numbers:

Number	Meaning
211	System status or help reply
214	Help message (Information on how to use the receiver or the meaning of a particular non-standard command; this reply is useful only to the human user)
220	<domain> Service ready
221	<domain> Service closing transmission channel
250	Requested mail action okay, completed
251	User not local; will forward to <forward-path>
252	Cannot VRFY user, but will accept message and attempt delivery
354	Start mail input; end with <CRLF>.<CRLF>
421	<domain> Service not available, closing transmission channel (This may be a reply to any command if the service knows it must shut down)
450	Requested mail action not taken: mailbox unavailable (for example, mailbox busy)
451	Requested action aborted: local error in processing
452	Requested action not taken: insufficient system storage
500	Syntax error, command unrecognized (This may include errors such as command line too long)
501	Syntax error in parameters or arguments
502	Command not implemented
503	Bad sequence of commands
504	Command parameter not implemented
550	Requested action not taken: mailbox unavailable (for example, mailbox not found, no access, or command rejected for policy reasons)
551	User not local; please try <forward-path>
552	Requested mail action aborted: exceeded storage allocation
553	Requested action not taken: mailbox name not allowed (for example, mailbox syntax incorrect)
554	Transaction failed (Or, in the case of a connection-opening response, "No SMTP service here")