C

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. C

#include <C_CkMailMan.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailMan mailman;
    HCkEmail email;

    success = FALSE;

    // 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.
    mailman = CkMailMan_Create();

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

    // Set the SMTP login/password (if required)
    CkMailMan_putSmtpUsername(mailman,"myUsername");
    CkMailMan_putSmtpPassword(mailman,"myPassword");

    // Create a new email object
    email = CkEmail_Create();

    CkEmail_putSubject(email,"This is a test");
    CkEmail_putBody(email,"This is a test");
    CkEmail_putFrom(email,"Chilkat Support <support@chilkatsoft.com>");
    success = CkEmail_AddTo(email,"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.

    CkEmail_AddHeaderField(email,"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 = CkMailMan_SendEmail(mailman,email);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(email);
        return;
    }

    success = CkMailMan_CloseSmtpConnection(mailman);
    if (success != TRUE) {
        printf("Connection to SMTP server not closed cleanly.\n");
    }

    printf("Mail Sent!\n");


    CkMailMan_Dispose(mailman);
    CkEmail_Dispose(email);

    }