PureBasic

Send Email with a vCard

Demonstrates how to create a simple email, attach a vcard, and send it. 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.
    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 vcard test")
    CkEmail::setCkBody(email, "This is a vcard test")
    CkEmail::setCkFrom(email, "Chilkat Admin <admin@chilkatsoft.com>")
    success = CkEmail::ckAddTo(email,"Chilkat Support","support@chilkatsoft.com")
    ; To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

    ; A vCard is an email attachment having a Content-Type = "text/x-vcard".
    ; Call AddStringAttachment to add a vcard from an in-memory string.
    ; The filename should have a ".vcf" file extension.  Chilkat will automatically
    ; recognize it and set the content-type to "text/x-vcard";

    ; Your application is responsible for providing the vcard formatted string.  For example:
    ; See http://en.wikipedia.org/wiki/VCard
    ; 
    ; begin:vcard
    ; fn:Matt Smith
    ; n:Smith;Matt
    ; org:Chilkat Software, Inc.
    ; tel;work:630-784-9670
    ; url:http://www.chilkatsoft.com
    ; version:2.1
    ; end:vcard

    vcard.s = "begin:vcard ..."
    success = CkEmail::ckAddStringAttachment(email,"admin.vcf",vcard)
    If success <> 1
        Debug CkEmail::ckLastErrorText(email)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    ; 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

    ; Some SMTP servers do not actually send the email until 
    ; the connection is closed.  In these cases, it is necessary to
    ; call CloseSmtpConnection for the mail to be  sent.  
    ; Most SMTP servers send the email immediately, and it is 
    ; not required to close the connection.  We'll close it here
    ; for the example:
    success = CkMailMan::ckCloseSmtpConnection(mailman)
    If success <> 1
        Debug "Connection to SMTP server not closed cleanly."
    EndIf

    Debug "Mail with vCard Sent!"


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


    ProcedureReturn
EndProcedure