This control encapsulates the SMTP protocol and compile with MIME version 1.0. This means that they can be used to send binary information as well as mail bodies containing characters like the Swedish characters åäöÅÄÖ. You can use this control to send mail over the Internet to a server on a UNIX machine or like.
It automatically handles decoding of message bodies in Quoted-Printable if needed. It also allow you to send attachments (binary or text) with your mail and will automatically encode them in BASE64. There is no restriction on the message and/or attachment size.
This is the second tool in a series of control for easy Internet programming in the Windows environment from Brattberg.
Transfer EsSmtp32.OCX to your \windows\system or \winnt35\system32 directory and register it by executing the command:
RegSvr32 \Windows\System\ESSMTP32.OCXRegSvr32.exe can be found on the Visual Basic 4.0 CD-ROM and in our ftp archive (http://www.ljusdal.se/esource/ftp/misc). If RegSvr32.exe fails, it's probably because you don't have the MFC 4.0 DLL library installed on your system. This is available from many sources on the Internet including our ftp archive as MFC40DLL.ZIP. Regsvr32.exe is also included in this archive. If you want to check if you already got the files in mfc40dll.zip they are
Read only.
Attachment count. Increased by one for every attachment added to the mail.
Read only.
If there are attachments this property fetches the type of a attachment specified by the zero based index. The number of attachments is defined by the Acount property.
Read only.
If there are attachments this property fetches the full path to an encoded attachment specified by the zero based index. . The number of attachments is defined by the Acount property.
Read only.
If there are attachments this property fetches the filename of a attachment specified by the zero based index. The number of attachments is defined by the Acount property.
The BCC header field. See the DestinationAddress property.
The CC (Carbon Copy) header field. See the DestinationAddress property.
Set to True to indicate that a delivery receipt is wanted when mail has bee delivered by the SMTP host.
Note that this is not supported among most mail delivery agents.
This is the email addresses for the receivers of this email. You can enter as many as you like separated by a comma.
This is your domain on the form yourdomain.com.
Read only.
Holds the last generated error-code. If you get a False return value form a method you should always check the ErrorNo property to determine the cause of the error.
If this property is set to True attachment data is not removed after a call to the send method.
Read only.
This read only property gives information on how many extra header lines that has been added.
This is the place where you handle extra header data. This header data should be entered on the form
X-extra header: some informationIf you set this property and use an index of an existing headerdata item (se the property HCount) this item is replaced with the new data. If you use an index that is larger than the number of extra header rows defined this line is added and the property HCount is increased by one. All data must be US-ASCII otherwise an error is thrown. Also it must not contain any CR (0x0d) or LF(0x0a) characters. You should prefix all strings with "X-".
You can also read the header data. You must then remember to set the zero bases index to a value less than HCount.
You can remove a specific row of header data with the RemoveHeaderData method or all Headerdata with the RemoveAllHeaderData method.
Note that extra header data rows is not automatically removed after a send operation. They are available and will be included in all mails until you remove them.
This is one place where an outgoing message can be entered. MailData is limited to a maximum of 32768 characters. If you want to send a message that is greater than this you can leave this property empty and send the message as an attachment.
The message is automatically encoded in Quoted Printable if needed. In this case the character set is defined as ISO-8859-1 otherwise US-ASCII and TEXT/PLAIN is used.
Read only.
This is a copy of the date/time field of the message and is set when mail has been transferred to the SMTP server.
Set this property to True if you want to receive a confirmation when your mail is read by its receiver(s).
Note that not all mail clients support this.
The IP address of the SMTP server on the form 192.34.12.44
You can obtain this address from a textual hostadress of the form mailhost.your.domain by using our control essock to resolve the address. Info on essock can be found at http://www.ljusdal.se/esource/ocx32.html.
This is the users email address on the form somone@somewhere.com
This is the name of your mailer application. This can be 'Your mailer application' or what ever you want. It defaults to nothing.
This is your users name as a real text string. If this property contains non US-ASCII characters it is coded in Quoted Printable with the character set ISO-8859-1 before the message is sent.
This is the subject line of your message. If this property contains non US-ASCII characters it is coded in Quoted Printable with the character set ISO-8859-1 before the message is sent.
Yet to be defined.
Yet to be defined.
Add an attachment to this mail coding it using base64 if needed or sending it as TEXT/PLAIN if no coding is needed.
The file parameter is the path to the file to attach.
Type is the type of the attachment. If set to 0 the type of the attachment is APPLICATION/OCTET-STREAM and it is encoded in base64. This is only done if the file needs to be encoded, otherwise TEXT/PLAIN is used. If set to another value a specific coding is used.
The coding of the file is done when you add the attachment and status events is fired during the coding process. You can use these events to inform your user about the progress of the encoding.
True is returned if the operation was successful.
Sends the mail, including any attachments, to the SMTP server. Status Events is fired periodically to give information about how much of the job that has been done. You can use these events to inform your user about the progress of the send operation.
With this method a specified attachment can be removed. The zero based index specifies the attachment to remove. The Acount property specifies the number of attachments available.
True is returned if the operation was successful.
With this method all attachments can be removed. This is usually done automatically when a mail has been sent. If the fDontRemove property is set to True they will however not be removed and this method or RemoveAttachment(i) must be used to remove attachments.
True is returned if the operation was successful.
Removes a header data row specified by the zero based index parameter. The number of specified header data rows is available in the HCount property.
True is returned if the operation was successful.
Removes all defined HeaderData rows.
Note that this is not automatically done when mail is sent.
True is returned if the operation was successful.
Status gives progress information when certain operations is in progress. This can be useful when you need to inform a user about the progress and what is happening during lengthy operations. The progress is directly expressed is percentage of the task completed. A task is always started with an event where progress=0 and ended with an event where progress = 100.
Sendmail and AddAttachment are methods which trigger this event.
It is possible that you are reading this documentation without having access to the control itself. If you have Internet access you just need to connect to http://www.ljusdal.se/esource and fetch a fully working sample of the control. At this location you can also find samples on how to use the control.
We can email the control anywhere in the world if you send us a request to do so. Please state if you want MIME or BINHEX coding. Send the request to f0002@brattberg.se
When you register the control we will send you the EsSmtp.lic file which will make the splash screen go away.
If you are entitled to a free registration, (please read our license agreement later in this document to find out if you are) , you have to fill in the form available at http://www.ljusdal.se/esource to receive the EsSmtp.lic file and get your free license. Note that the free license does not allow you to get support or distribute applications made with the control unless these also are made available free of charge or is used within your nonprofit organization.
If you are not entitled for a free licens you have to pay for the control. This could be done in several ways.
We work together with PsL on this and here is how you go ahead: Note that this option is for CREDIT CARD ORDERS ONLY.
EsSmtp has Item Number 14606 at PsL.
You can order with MC, Visa, Amex, or Discover from Public (software) Library by calling (USA) 800-2424-PsL or (USA) 713-524-6394 or by FAX to (USA) 713-524-6398 or by CIS Email to 71355,470 Internet email to 71355,470@compuserv.com.
You can also mail credit card orders to PsL at P.O.Box 35705, Houston, TX 77235-5705, USA.
THE ABOVE NUMBERS ARE FOR CREDIT CARD ORDERS ONLY.
BRATTBERG CANNOT BE REACHED AT THESE NUMBERS.
Any questions about the status of the shipment of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, non-credit card orders, etc, must be directed to Brattberg, Gruvbyn 415A, S-820 50 LOOS, Sweden Phone: +46 657 10620, Fax: +46 657 105 13 email: f0002@brattberg.se or by use of on-line facilities at http://www.ljusdal.se/esource.
To insure that you get the latest version, PsL will notify us the day of your order and we will ship the EsSmtp directly to you. If you take the option of email-shipping you will usually have the licensed control the same day.
You can also make this registration online via you web-browser. The URL: is
http://206.109.101.6/cgi-win/psl_ord.exe/ITEM14606
or follow the links at
You can also go to
http://206.109.101.6/register.htm
and look up EsSmtp to make your online registration. But for the last time. This is only for Credit card orders.
Some, mostly larger, companies need an invoice before they can make any financial transactions . We can handle this situation as well. Just send us a fax ( +46 657 10513) or email (f0002@brattberg.se) or use the online facilities at http://www.ljusdal.se/esource or send a letter to Brattberg, Gruvbyn 415A, S-820 50 LOOS, Sweden to place your order.
We will add a Invoice fee (Currently $10) and sails tax (if you are located within the European Community) to your order. You get a credit of 30 days. We usually ship the control the same day we receive your order.
If you send us a check it should be made payable to Brattberg, Gryvbyn 415A, S-820 50 LOOS, Sweden. Please add $5 to the total amount of your order if you use this option. If you fax us a copy of your check we will ship the control to you (just email) the same day we receive the fax.
There are several options you can use for this kind of transfer. You can make a SWIFT transfer to FOBA SESS 7759-15-01828.
You can use our Banktransfer account (Bankgiro in Swedish) which is 5321-5117
Put the money for the control in an envelop and post to us. This works most of the time but the risk is yours not ours.
EsSmtp Control for USD 12
You get access to all versions of a control under one year. This means that a control that is published as 16-bit/32-bit ActiveX (OCX) and 16-bit/32-bit DLL and a VBX are all covered by this registration fee. You also get free support.
Brattberg Control Subscription for USD 450
Yes its only $150! This option gives you all controls and all source produced in our company for one year. You also get support as if you bought each of the controls.
Traditional media (Diskette) add USD 10
We ship anywhere in the world with World-wide First Class/Airmail if you select this option. The only media supported is 3.5" diskettes.
Additional information we want from you when you place an order:
You can get support by sending email to f0002@brattberg.se. You can also find relevant information on-line at http://www.ljusdal.se/esource
We also have set up mailinglists for all of our controls. If you want to subscribe to the EsSmtp mailinglist send a letter to EsSmtp-request@ljusdal.se with "subscribe" as your subject. This will make you a subscriber of this list. You can also send a letter with "help" as the subject to get more information. To unsubscribe to the list just send a letter with "unsubscribe" as the subject. After a subscribing to a list you can send your comments, questions etc. to EsSmtp@ljusdal.se.
We also have mailinglists for all other controls and
We also check the newsgroup comp.lang.basic.visual.3rdparty on a regular basis and will try to help on all questions posted there we also check the relevant newsgroups at the Microsoft news server from time to time.
If you need to contact us the preferred way is through email. Please send a mail to f0002@brattberg.se
If you want to use phone please call us at +46 657 10620 and if you want to fax us please use +46 657 10513.
If you want to send a snailmail you can send it to
BRATTBERG, Gruvbyn 415A, S-820 50 LOOS, SWEDENWe have a very liberal license policy so please read the license agreement text below . You are not allowed to use this control for other then evaluation purposes without register it with us. But if you are a student or involved in a non-profit organization there is no registration fee. Please read the license agreement to find out if you are entitled to a free registration or not.
If you intend to use the control in a commercial organization or want to develop an application which you intend to sell you will find that the license cost is very moderate. Please read the complete license agreement.