(Tcl) Transition from Imap.CheckForNewEmail to Imap.QueryMbx

Provides instructions for replacing deprecated CheckForNewEmail method calls with QueryMbx.

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

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

set imap [new_CkImap]

# ...
# ...

# ------------------------------------------------------------------------
# The CheckForNewEmail method is deprecated:

# msgSetObj is a CkMessageSet
set msgSetObj [CkImap_CheckForNewEmail $imap]
if {[CkImap_get_LastMethodSuccess $imap] == 0} then {
    puts [CkImap_lastErrorText $imap]
    delete_CkImap $imap
    exit
}

# ...
# ...

delete_CkMessageSet $msgSetObj

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

set criteria "new-email"
set bUid 1

set msgSet [new_CkMessageSet]

set success [CkImap_QueryMbx $imap $criteria $bUid $msgSet]
if {$success == 0} then {
    puts [CkImap_lastErrorText $imap]
    delete_CkImap $imap
    delete_CkMessageSet $msgSet
    exit
}


delete_CkImap $imap
delete_CkMessageSet $msgSet