1. Introduction
2. Getting Started
3. Attachments
4. Embedded Images
5. Security
6. Unicode
7. Queuing Part I
8. Queuing Part II
Object Reference





Newsletter Signup
File Upload Component
Encryption and Secure Mail Component
Data-bound Editable Grid Component

Chapter 2: Getting Started Chapter 1. Introduction

What is AspEmail?

AspEmail 5.0 is an active server component for sending e-mail messages using an external SMTP server in an ASP or VB environment. AspEmail 5.0 supports multiple recipients, multiple file attachments, HTML format, embedded images and sounds, non-US ASCII character sets, secure mail, and high-performance message queuing.

AspEmail's basic functionality, including file attachment and HTML support, is absolutely free. Premium features require a registration key after a 30-day evaluation period.

A copy of AspEmail can be downloaded from www.aspemail.com/download.html.

What's New in AspEmail 5.0

  • Memory attachments. You can now attach files directly from a database blob or memory upload without creating a temporary copy of the file on disk.

  • Full Unicode support. Unicode characters can now be used both in message body and headers. Various encoding schemes are provided including UTF-8.

  • Message queuing completely rewritten, with dramatic improvement in performance. Messages are placed in the queue as plain ASCII files that can be easily viewed and modified by hand. The new version of EmailAgent allows for up to 64 simultaneous SMTP sessions. A failed message will be automatically re-sent multiple times.

  • Logging with programmatic access. EmailAgent 5.0 logs success and failure results into an ASCII file that can be accessed both manually and programmatically.

  • Bounced message handling. EmailAgent 5.0 polls a POP3 account specified as the recipient of bounced mail, downloads bounced messages and extracts failed email addresses from them for further processing.

  • DNS Relay. Queued messages can be sent using the recipients' own SMTP servers as opposed to using a local relay server.

  • NTLM and CRAM-MD5 authentication methods in the message queuing mode. Previous versions only provided support for the AUTH=LOGIN authentication method.

  • Queuing support for secure mail. Previous versions did not allow encrypted or signed messages to be queued.

AspEmail Feature Summary

  • Sends e-mail using an external SMTP server programmatically.
  • Supports multiple recipients, CC's, BCC's, Reply-To's, file attachments.
  • Supports HTML format.
  • Embedded images and sounds (multipart/related).
  • Sends messages in both HTML and text formats (multipart/alternative).
  • Secure mail in the S/MIME format, when used in tandem with AspEncrypt.
  • Various SMTP authentication methods (enhanced in 5.0).
  • High-volume message queuing support.
  • Deferred message delivery.
  • NNTP support.
  • NEW Memory attachments.
  • NEW Up to 64 simultaneous SMTP sessions when sending out queued mail.
  • NEW Multiple attempts to resend a failed message.
  • NEW Bounced message handling.
  • NEW Full Unicode support in message body and headers.
  • NEW Advanced logging.

System Requirements

  • Windows NT/2000/XP/95/98/ME.
  • ASP, IIS or PWS (any version), or
  • Any development environment supporting COM.

Installation

The AspEmail 5.0 package is comprised of the following executable files:
  • AspEmail.dll - the actual AspEmail component library. All other files are only needed if message queuing is used.

  • EmailAgent.exe - the EmailAgent Windows service running in the background to send queued mail.
  • EmailAgentCfg.cpl - the EmailAgent configuration applet appearing in Control Panels.
  • EmailLogger.dll - the logging component which provides programmatic access to the EmailAgent log file.
The setup application aspemail.exe downloadable from the AspEmail.com web site automatically installs all these files along with the documentation and code samples.

In case you need to install the product manually, do the following:

1. Place the file AspEmail.dll in any directory on the server, and register it using the regsvr32 command-line utility:

c:\AspEmail>regsvr32 aspemail.dll

Unless you wish to use message queuing, you are done. If you want to utilize the EmailAgent Windows service for background processing of queued messages, install the EmailAgent files as follows:

2. Place the file EmailAgent.exe in any directory on the server and register it by executing the following command:

c:\AspEmail>EmailAgent -install

The EmailAgent service should now appear in the Services Control Panel, under the name Persits Software EmailAgent. Note that previous versions of EmailAgent (prior to 5.0) appear in the Services list under the name Persits Software Email Agent (with a space between the words "Email" and "Agent").

3. Copy the file EmailAgentCfg.cpl into the \system32 directory of your Windows installation.

4. Register EmailLogger.dll the same way as aspemail.dll using regsvr32.

Uninstalling AspEmail and EmailAgent
To uninstall AspEmail manually, shut down IIS (net stop iisadmin /y) and stop EmailAgent from Control Panels.

1. Unregister aspemail.dll and emaillogger.dll as follows:

c:\AspEmail>regsvr32 /u aspemail.dll
c:\AspEmail>regsvr32 /u emaillogger.dll

2. Delete the file EmailAgentCfg.cpl from the \system32 directory.

3. Uninstall EmailAgent by executing the command

c:\AspEmail>EmailAgent -remove

Chapter 2: Getting Started 


Copyright © 1999 - 2003 Persits Software, Inc.
All Rights Reserved
Questions? Comments? Write us!