PureBasic

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

IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

    success.i = 0

    ; 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.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Set the SMTP server (obviously, use your SMTP server, not chilkatsoft.com)
    CkMailMan::setCkSmtpHost(mailman, "smtp.chilkatsoft.com")

    ; Set the SMTP login/password (if required)
    CkMailMan::setCkSmtpUsername(mailman, "myUsername")
    CkMailMan::setCkSmtpPassword(mailman, "myPassword")

    ; Create a new email object
    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "This is a test")
    CkEmail::setCkBody(email, "This is a test")
    CkEmail::setCkFrom(email, "Chilkat Support <support@chilkatsoft.com>")
    success = CkEmail::ckAddTo(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::ckAddHeaderField(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::ckSendEmail(mailman,email)
    If success <> 1
        Debug CkMailMan::ckLastErrorText(mailman)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    success = CkMailMan::ckCloseSmtpConnection(mailman)
    If success <> 1
        Debug "Connection to SMTP server not closed cleanly."
    EndIf

    Debug "Mail Sent!"


    CkMailMan::ckDispose(mailman)
    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure