Greyware Mail DLL (GWMail32)

Version History

1.4.b.20000528 - added support for multiple SMTP hosts; added support for non-standard SMTP port numbers; fixed bug that could cause sending email to hang if the SMTP server responds with non-standard responses to SMTP commands. Added #ifdef __cplusplus syntax to gwmail32.h to assist those compiling in a mixed C and C++ environment.
1.3.b.20000306 - added < and > to RCPT TO (to comply with RFC 821 for older servers)
1.3.b.19991210 - added code to strip redundant CRLFs after the message body
1.3.b.19990510 - Alpha version released
1.2.b.980306 - added support for non-cannonical email names
1.2.b.980227 - first public release
1.1.b.970104 - added simplified declarations for common functions
1.0.b.960203 - internal use release. Basic functionality established

Notes

Multiple SMTP hosts: As of version 1.4, you may specify more than one SMTP host. The DLL will try them in order, and use the first host that responds. Separate hosts with a comma or semicolon. For example:

    smtp.yourhost.com;fallback1.yourhost.com;fallback2.yourhost.com
    // tries smtp.yourhost.com first; if server unavailable, tries fallback1.yourhost.com;
    // if fallback1 unavailable, tries fallback2, etc.

Specified SMTP ports: As of version 1.4, you may specify the SMTP port for each host. If you do not specify a port, the DLL will use the RFC-specified port 25. To force the DLL to use a port other than 25, add it to the end of the host name with a colon. For example:
```
    smtp.yourhost.com:2525                      // uses port 2525 instead of port 25
    smtp.yourhost.com;smtp.yourhost.com:2525    // tries port 25 first, then port 2525
    
```
Decorated Names: The DLL supports either standard or decorated email addresses. A standard email address is one with a username, at-sign, and host/domain. Example: sales@greyware.com
A decorated email address includes information for the recipient's email client to display instead of the plain email address. The DLL supports two variations of decorated names:
Example 1: Sales Department <sales@greyware.com>
Example 2: "Sales Department" sales@greyware.com

The email will be delivered to sales@greyware.com, but most email clients will show the address as Sales Department.
The main documentation for the various calls may be found within the comments of the C/C++ include file, gwmail32.h. Declarations for other languages may easily be derived from the information in gwmail32.h.
If your project is written using C or C++, then you may want to include the LIB file, gwmail32.lib in your project at compile time. You may also use Win32's LoadLibrary() function to use the DLL dynamically.
If your project is written using Visual Basic, you might find this sample program helpful: gwmail.frm which uses declarations in gwmail.bas. Any other VB declarations can be derived from the information in gwmail32.h.

Sample C Program

#include <windows.h>
#include <stdio.h>
#include gwmail32.h

//
// link with kernel32.lib, user32lib, and gwmail32.lib
//

//
// compile as a CONSOLE program
//

// sample program showing SendSMTPEx syntax in use--
// be sure to change the parameters to reflect YOUR
// setup!

int main(void)
{
    DWORD       dwResult;
    char        szError[128];

    //
    // send a quick test message
    //

    dwResult = SendSMTPMessage(
        "smtp.greyware.com",       // SMTP Host
        "jeffryd@greyware.com",    // From
        "sales@greyware.com",      // To
        "Test of GWMail32",        // Subject
        "Just a message....");     // Message

    //
    // display the results
    //

    GWMailFormatMessage(dwResult,szError,sizeof(szError));
    printf("SendSMTPMessage result: %s\n",szError);
    if (dwResult != ERROR_SUCCESS) return dwResult;

    //
    // send a quick file
    //

    dwResult = SendSMTPFile(
        "smtp.greyware.com",         // SMTP Host
        "jeffryd@greyware.com",    // From
        "sales@greyware.com",      // To
        "c:\\boot.ini");           // Filename
    //
    // display the results
    //

    GWMailFormatMessage(dwResult,szError,sizeof(szError));
    printf("SendSMTPMessage result: %s\n",szError);
    if (dwResult != ERROR_SUCCESS) return dwResult;
        
    //
    // send some email; include an attached file in
    // uuencode format just for fun
        
    dwResult = SendSMTPEx(
        "smtp.greyware.com",          // SMTP Host
        "jeffryd@greyware.com",     // From
        "sales@greyware.com",       // To
        "techsupport@greyware.com", // Cc
        NULL,                       // Bcc, NULL = none
        "Test of GWMail32",         // Subject
        NULL,                       // Errors-To (not used)
        NULL,                       // Reply-To (not used)
        "This is a test message.",  // The message
        "c:\\boot.ini",             // Attached File
        FALSE,                      // don't bother with DOS name
        ENCODING_UUENCODE);         // use UUENCODE

    //
    // display the results
    //

    GWMailFormatMessage(dwResult,szError,sizeof(szError));
    printf("SendSMTPEx result: %s\n",szError);
    return dwResult;
}