(Tcl) Transition from MailMan.FetchEmail to MailMan.FetchByUidl

Provides instructions for replacing deprecated FetchEmail method calls with FetchByUidl.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

set mailman [new_CkMailMan]

# ...
# ...

set uidl "123"

# ------------------------------------------------------------------------
# The FetchEmail method is deprecated:

# emailObj is a CkEmail
set emailObj [CkMailMan_FetchEmail $mailman $uidl]
if {[CkMailMan_get_LastMethodSuccess $mailman] == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    exit
}

# ...
# ...

delete_CkEmail $emailObj

# ------------------------------------------------------------------------
# Do the equivalent using FetchByUidl.
# Your application creates a new, empty Email object which is passed 
# in the last argument and filled upon success.

set headerOnly 0
# Irrelevant because we are not downloading headers-only.
set numBodyLines 0

set emailOut [new_CkEmail]

set success [CkMailMan_FetchByUidl $mailman $uidl $headerOnly $numBodyLines $emailOut]
if {$success == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    delete_CkEmail $emailOut
    exit
}


delete_CkMailMan $mailman
delete_CkEmail $emailOut