POP3 ActiveX Control

ActiveX: SLPOP (Filename: SLPOP3.OCX)

SLPOP is an ActiveX control that can be used to download e-mail messages (or just the message headers) from a POP3 server. The control can also check the number of waiting mails on the server and their sizes. SLPOP uses the POP3 protocol (specified in RFC 1939) when communicating with the mail server.

Properties

Name	Type	Description
MailBody	String	This property will contain the body text for a downloaded mail.
MailFrom	String	This property will contain the sender's e-mail address of a downloaded mail. This property will also obtain a value if you call the GetMailHeader method.
MailHeader	String	This property will contain the mail header of a downloaded message. This property will also obtain a value if you call the GetMailHeader method.
MailPort	Long	Specifies the port number to use when connecting to the POP3 server. The default value for this property is 110 and normally you never need to change the value.
MailReplyTo	String	This property will contain the sender's reply e-mail address of a downloaded mail. This property will also obtain a value if you call the GetMailHeader method.
MailServer	String	Specifies the POP3 server to use when downloading e-mails.
MailSubject	Long	This property will contain the subject field of a downloaded message. This property will also obtain a value if you call the GetMailHeader method.
Password	String	Specifies the password to use when connecting to the POP3 server.
UseLog	Boolean	Enables/disables using of a log file in the control. If this property has the value True a log file with the filename SLPOP3AX.LOG will be created. This log file contains detailed information about the POP3 communication between the client and the mail server. In Windows XP and earlier the log file is stored in the Windows folder. In Windows Vista the log file is stored in the following folder: \Users\<User>\AppData\Roaming\SamLogic\Log Files
UserName	String	Specifies the user name to use when connecting to the POP3 server.

Events

Name	Description
Connected	This event is fired when a connection to the POP3 server is established.
Disconnected	This event is fired when the connection to the POP3 server is disconnected.
ErrorOccured	This event is fired if an error occurs when communicating with the POP3 server.
MailHeaderReceived	This event is fired when an e-mail message header have been successfully downloaded using the GetMailHeader method.
MailReceived	This event is fired when an e-mail have been successfully downloaded using the ReceiveMail method.
MailServerReportedError	This event is fired if the mail server reports an error or denies access. The Operation parameter specifies at what step in the communication process the error occurred. Some common values for Operation is: 1 = The error occurred when the user name was sent. 2 = The error occurred when the password was sent. 5 = The error occurred when the e-mail message header was downloaded. 7 = The error occurred when the e-mail was downloaded.
MailSizeReceived	This event is fired when the size of a mail have been retrieved using the GetMailSize method.

Methods

Connect () As Boolean

Opens a connection to the POP3 server. The method returns True if successful, or False otherwise. If a successful connection has been established, the Connected event is fired.

Disconnect () As Boolean

Disconnects (logs off) from the server. The method returns True if successful, or False otherwise.

Break ()

Cancels current operation. This method can be used to break the connection if the mail server is not responding in a given amount of time.

Delete (MailNumber As Integer) As Boolean

Deletes a specified e-mail at the POP3 server. The MailNumber parameter specifies which mail that should be deleted. The first mail has the value 1, the second mail has the value 2 etc. The mails are physically removed from the server when the Disconnect method is called. The method returns True if successful, or False otherwise.

GetLastError () As Long

Returns an error code for the last error that occurred in the control. A list of error codes is available here.

GetLastReplyCode () As Long

Returns the last reply code from the POP3 server. Is always one of the following values: 1 = OK, 0 = error or 2 = can't determine.

GetMailHeader (MailNumber As Integer) As Boolean

Downloads an e-mail message header. The MailNumber parameter specifies the mail which header should be downloaded. The first mail has the value 1, the second mail has the value 2 etc. When a mail header have arrived, the MailHeaderReceived event is fired. You can then obtain the mail header by reading the MailHeader property. Some fields in the mail header can be obtained by reading the MailFrom, MailReplyTo and MailSubject properties. The method returns True if successful, or False otherwise.

GetMailSize (MailNumber As Integer) As Boolean

Returns the size of a specified e-mail in the POP3 server. The MailNumber parameter specifies the number of the mail to examine. The first mail has the value 1, the second mail has the value 2 etc. When the size have arrived from the server to the client computer, the MailSizeReceived event is fired. The method returns True if successful, or False otherwise.

GetNumWaitingMails () As Integer

Returns the number of waiting e-mails in the POP3 server.

GetSizeWaitingMails () As Integer

Returns the total size in bytes of the waiting e-mails in the POP3 server.

ReceiveMail (MailNumber As Integer) As Boolean

Downloads a mail from the POP3 server. The MailNumber parameter specifies which mail that should be downloaded. The number of the first mail is 1. When an e-mail have been downloaded, the MailReceived event is fired. After a successful download, the mail body can be obtained by reading the MailBody property. The subject can be obtained by reading the MailSubject property. Other properties that can be used to get information about the downloaded mail is MailFrom and MailReplyTo.

This method do not delete the mail from the mail server. You must call the Delete method to remove the mail. The method returns True if successful, or False otherwise.

Example

Click here for an example of how to use the SLPOP ActiveX