Greyware Automation Products, Inc.
    Greyware Automation Products, Inc.
Menubar Left Endcap      Home    Products    Store    Downloads    Customer Service    Search    
Menubar Right Endcap
    Log in  or   Create an account now -- FREE!
GWXMail   
 Overview 
 Support 
 Pricing 
    Buy It           
 - Try It, FREE! - 

Send properly-formatted SMTP email with no ASP programming!


No need to bother with programming any of the the SMTP/ESMTP protocol details!

 Overview

GWXMail is a server-side Active X component that interfaces with GWMail32 to let you send SMTP mail directly from your ASP web pages.

GWXMail DLL handles all the complexity of Winsock communications and the SMTP/ESMTP protocols. Greyware Mail DLL is designed to be as bullet-proof and easy-to-use as possible. It uses intelligent defaults, and provides clear plain-English error messages.

Requirements


    GWXMail is only supported on NT 4.x or NT 5.x, running Microsoft's IIS version 4.0 or later.

    GWXMail is a standard Active X component, so can be called from VB, Visual C/C++, or any other development environment that supports Active X. Only support for calling GWXMail from an ASP page is documented.

Setup and Installation


    Copy gwxmail.dll to the system32 directory (usually C:\WINNT\SYSTEM32) of your web server. Click Start, then choose Run. On the Open line, type regsvr32 c:\winnt\system32\gwxmail.dll and click OK.

    If gwmail32.dll is not already on the web server, copy it to the system32 directory, too. You do not need to run regsvr32 for gwmail32.dll.

    If you have trouble registering GWXMail, check our online knowledgebase for tips.

Version History


  • 1.0.b.981028 - fixed bug in WriteLine property that sometimes caused premature truncation of the message buffer
  • 1.0.b.981013 - initial public release
  • 1.0.b.980920 - beta test release

Notes


    GWXMail is easy to use. To show you just how easy, here's a sample ASP file that sends an email:
    <%
        Set Mailer = Server.CreateObject("GWXMail.Mailer")
        Mailer.Clear
        Mailer.SMTPHost = "127.0.0.1;smtp.greyware.com"
        Mailer.AddrTo = "sales@greyware.com, info@greyware.com"
        Mailer.From = "Jeffry Dwight <jeffryd@greyware.com>"
        Mailer.Subject = "Test of GWXMail"
        Mailer.Message =  "Hi.  Just testing GWXMail.  Pretty easy, huh?"
        Mailer.Send
        If Mailer.Error then
            Response.Write "Oops! " & Mailer.ErrorMessage
        Else
            Response.Write "Cool!  " & Mailer.Subject & " was sent "
            Response.Write "using " & Mailer.SMTPHost & "."
        End If
        Set Mailer = Nothing
    %>
        
    As this example shows, email addresses can be either standard format (as shown in the AddrTo line above) or include a friendly name (as shown in the From line above). The portion of the address containing the @ sign is used when actually sending the email; the whole address, however you specify it, is sent with the extra headers.

    You may include multiple recipients in the AddrTo, CC, or BCC statements, provided that you separate the recipients with a comma (as shown in the AddrTo line of the example above).

    This example also shows that most of the properties are read/write, meaning that your code can both set the properties with an assignment statement (writing, as shown in the Mailer.AddrTo = line), or refer to the current value (reading, as shown in the Response.Write lines).

Methods


    The following methods are supported by the GWXMail.Mailer object:

    Clear  Resets all parameters to their defaults and clears the message buffer.
    Send  Sends the message buffer, plus any attachments. Check the Error property after using the Send method to determine whether or not your mail was sent successfully.

Properties


    The following properties are supported by the GWXMail.Mailer object:

    AddrTo read writeRequired. Sets or returns the name(s) of the recipient(s).
    BCC read writeOptional. Sets or returns the name(s) of the BCC recipient(s).
    CC read writeOptional. Sets or returns the name(s) of the CC recipient(s).
    Encoding read writeOptional. Sets or returns an integer representing the encoding method to use for the attached file. Default is ENCODING_AUTO.
    Error read onlyReturns a long indicating the last error encountered (zero means no error).
    ErrorMessage read onlyReturns a textual description of the last error encountered.
    ErrorsTo read writeOptional. Sets or returns the email address for the ErrorsTo header.
    Filename read writeRequired if sending a file. Sets or returns the path and name of a file to attach.
    From read writeRequired. Sets or returns the name of the sender.
    Message read writeRequired for email without an attachment, unless message buffer set with WriteChars or WriteLine. Sets or returns the contents of the message buffer. Note, setting this property will overwrite anything already in the message buffer, including text placed there with WriteChars or WriteLine.
    ReplyTo read writeOptional. Sets or returns the email address for the ReplyTo header.
    SMTPHost read writeRequired. Sets or returns the name or IP address (specified as a string) of the SMTPHost to use.
    Subject read writeOptional. Sets or returns the email's subject.
    UseDOSName read writeOptional. Sets or returns a Boolean value controlling whether to generate a short file name for the attached file. Default is FALSE.
    Version read onlyReturns a string indicating the GWXMail version.
    WriteChars write onlyOptional. Appends text to the message buffer.
    WriteLine write onlyOptional. Appends text plus a CRLF to the message buffer.

Constants


    The following constants are used with GWXMail. In your code, you may either define the constants and then use their names (recommended), or use the numeric values directly.
        ENCODING_AUTO = 0      ' to let DLL determine encoding
        ENCODING_DEFAULT = 0   ' synonym
        ENCODING_TEXT = 1      ' to force plain text (no encoding)
        ENCODING_UUENCODE = 2  ' to force UUENCODE
        ENCODING_BASE64 = 3    ' to force MIME Base64 encoding
        ENCODING_MIME = 3      ' synonym
    
    If ENCODING_AUTO is used (default), GWXMail will determine whether or not the attached file needs to be encoded. If the file appears to be text, GWXMail will incorporate it into the body of the letter, after anything that may be in the message buffer. (If you are attaching a file, you are not required to set the Message property.)

    Any other encoding method forces GWXMail to use that method, no matter what the contents of the file may be.

ArrowSee our complete catalog of software...             
Menubar Left Endcap      Home      Top of this Page      Store      Downloads       Printer-Friendly Version      Menubar Right Endcap
 
Copyright © 1995-2009 Greyware Automation Products, Inc.  All Rights Reserved
All Trademarks mentioned are the properties of their respective owners.
Privacy Policy ]   [ Contact Greyware ]   [ Feedback to Greyware ]