Xbase++

Send Email with a vCard

Demonstrates how to create a simple email, attach a vcard, and send it. Xbase++

LOCAL nSuccess
LOCAL oMailman
LOCAL oEmail
LOCAL cVcard

nSuccess := 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.
oMailman := CreateObject("Chilkat.MailMan")

//  Set the SMTP server.
oMailman:SmtpHost := "smtp.chilkatsoft.com"

//  Set the SMTP login/password (if required)
oMailman:SmtpUsername := "myUsername"
oMailman:SmtpPassword := "myPassword"

//  Create a new email object
oEmail := CreateObject("Chilkat.Email")

oEmail:Subject := "This is a vcard test"
oEmail:Body := "This is a vcard test"
oEmail:From := "Chilkat Admin <admin@chilkatsoft.com>"
nSuccess := oEmail:AddTo("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

cVcard := "begin:vcard ..."
nSuccess := oEmail:AddStringAttachment("admin.vcf", cVcard)
IF (nSuccess != 1)
    ? oEmail:LastErrorText
    oMailman:destroy()
    oEmail:destroy()
    RETURN
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.  
nSuccess := oMailman:SendEmail(oEmail)
IF (nSuccess != 1)
    ? oMailman:LastErrorText
    oMailman:destroy()
    oEmail:destroy()
    RETURN
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:
nSuccess := oMailman:CloseSmtpConnection()
IF (nSuccess != 1)
    ? "Connection to SMTP server not closed cleanly."
ENDIF

? "Mail with vCard Sent!"

oMailman:destroy()
oEmail:destroy()