(MFC) Send High Priority Email (SMTP, X-Priority header)

Demonstrates how to send high-priorty email (or lower priority email) by setting the X-Priority header field.

Chilkat C/C++ Library Downloads MS Visual C/C++ Libs

See Also: Using MFC CString in Chilkat

#include <CkMailMan.h>
#include <CkEmail.h>

void ChilkatSample(void)
    {
    CkString strOut;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // The mailman object is used for sending and receiving email.
    CkMailMan mailman;

    // Set the SMTP server (obviously, use your SMTP server, not chilkatsoft.com)
    mailman.put_SmtpHost("smtp.chilkatsoft.com");

    // Set the SMTP login/password (if required)
    mailman.put_SmtpUsername("myUsername");
    mailman.put_SmtpPassword("myPassword");

    // Create a new email object
    CkEmail email;

    email.put_Subject("This is a test");
    email.put_Body("This is a test");
    email.put_From("Chilkat Support <support@chilkatsoft.com>");
    bool success = email.AddTo("Chilkat Admin","admin@chilkatsoft.com");
    // To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

    // To send high-priority email, 
    // add the X-Priority header field with the value "1" 
    // to indicate highest-priority.
    // A value of "3" is normal, which is the same as not setting
    // the X-Priority header at all, and "5" is the lowest. 
    // "2" and "4" are in-betweens.

    // Microsoft Outlook might add the following headers when
    // sending high-priority email.

    // X-Priority: 1 (Highest) 
    // X-MSMail-Priority: High 
    // Importance: High 

    // The X-Priority header alone is enough to make the email high-priority.

    email.AddHeaderField("X-Priority","1");

    // Call SendEmail to connect to the SMTP server and send.
    // The connection (i.e. session) to the SMTP server remains
    // open so that subsequent SendEmail calls may use the
    // same connection.  
    success = mailman.SendEmail(email);
    if (success != true) {
        strOut.append(mailman.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    success = mailman.CloseSmtpConnection();
    if (success != true) {
        strOut.append("Connection to SMTP server not closed cleanly.");
        strOut.append("\r\n");
    }

    strOut.append("Mail Sent!");
    strOut.append("\r\n");


    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());

    }