Tcl

Send Email with a vCard

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

load ./chilkat.dll

set success 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.
set mailman [new_CkMailMan]

# Set the SMTP server.
CkMailMan_put_SmtpHost $mailman "smtp.chilkatsoft.com"

# Set the SMTP login/password (if required)
CkMailMan_put_SmtpUsername $mailman "myUsername"
CkMailMan_put_SmtpPassword $mailman "myPassword"

# Create a new email object
set email [new_CkEmail]

CkEmail_put_Subject $email "This is a vcard test"
CkEmail_put_Body $email "This is a vcard test"
CkEmail_put_From $email "Chilkat Admin <admin@chilkatsoft.com>"
set success [CkEmail_AddTo $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

set vcard "begin:vcard ..."
set success [CkEmail_AddStringAttachment $email "admin.vcf" $vcard]
if {$success != 1} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkMailMan $mailman
    delete_CkEmail $email
    exit
}

# 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.  
set success [CkMailMan_SendEmail $mailman $email]
if {$success != 1} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    delete_CkEmail $email
    exit
}

# 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:
set success [CkMailMan_CloseSmtpConnection $mailman]
if {$success != 1} then {
    puts "Connection to SMTP server not closed cleanly."
}

puts "Mail with vCard Sent!"

delete_CkMailMan $mailman
delete_CkEmail $email