(PureBasic) MailMan GetSentToEmailAddrs

Demonstrates how to get the email addresses accepted by the SMTP server during an SMTP send.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkStringArray.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    ; Demonstrates how to get the successful recipients for the last email sent.

    ; Note: Success does not ensure actual delivery, nor does it mean the email address is actually valid.
    ; It may be that the email address is invalid and will get bounced at the destination.

    ; Also: An SMTP client (such as Chilkat, Mozilla Thunderbird, etc.) is only responsible for "handing off" the email to the SMTP server 
    ; for delivery (either to a local mailbox, or to a remote mailbox where the SMTP server acts as a relay). 
    ; The SMTP client's task is ended when the SMTP protocol exchange is completed, and the SMTP server says "OK, I've got it and I'll take it from here.". 
    ; If the email never actually gets delivered, then there is a problem downstream of the Chilkat-->SMTP server handoff.

    mailman.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkMailMan::setCkSmtpHost(mailman, "outlook.office365.com")
    CkMailMan::setCkSmtpPort(mailman, 587)
    CkMailMan::setCkStartTLS(mailman, 1)

    ; Set the SMTP login/password
    CkMailMan::setCkSmtpUsername(mailman, "OFFICE365-SMTP-LOGIN")
    CkMailMan::setCkSmtpPassword(mailman, "OFFICE365-SMTP-PASSWORD")

    ; Create a new email object
    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "Testing for Chilkat API...")
    CkEmail::setCkBody(email, "Testing for Chilkat API...")
    CkEmail::setCkFrom(email, "Chilkat Support <my-office365-user@mydomain.com>")
    success.i = CkEmail::ckAddTo(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.

    ; Allow SendEmail to succeed even if some recipients are rejected immediately
    ; by the SMTP server.
    CkMailMan::setCkAllOrNone(mailman, 0)

    ; 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

    success = CkMailMan::ckCloseSmtpConnection(mailman)
    If success <> 1
        Debug "Connection to SMTP server not closed cleanly."
    EndIf

    Debug "Mail Sent!"

    ; Examine which email addresses were accepted by the SMTP server during the SMTP conversation. 
    ; (i.e. during the SendEmail)
    acceptedAddrs.i = CkMailMan::ckGetSentToEmailAddrs(mailman)
    numAddrs.i = CkStringArray::ckCount(acceptedAddrs)
    i.i = 0
    While i < numAddrs
        Debug "Accepted recipient " + Str(i) + ": " + CkStringArray::ckGetString(acceptedAddrs,i)
        i = i + 1
    Wend
    CkStringArray::ckDispose(acceptedAddrs)



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


    ProcedureReturn
EndProcedure