(DataFlex) MailMan GetBadEmailAddrs

Demonstrates how to get the email addresses flagged as invalid during an SMTP send.

Note: An SMTP server can only issue errors for email addresses under it's own domain. For example, if using smtp.gmail.com to send email, the GMail server can only know what emails in the gmail.com domain are invalid. If, for example, the "TO" recipient is "doesNotExist@chilkatsoft.com", then the email would be accepted. If it's not actually a valid email address, it is not flagged as an error during the client-to-SMTP-server conversation. (If the email address turns out to be truly invalid, then a DSN (Delivery Status Notification, or "bounce") email *might* be sent by the final destination mail server to the return address.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoMailman
    Variant vEmail
    Handle hoEmail
    Boolean iSuccess
    Variant vBadAddrs
    Handle hoBadAddrs
    Integer iNumBadAddrs
    Integer i
    String sTemp1

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

    // Demonstrates how to get the list of invalid email addresses flagged by the SMTP server
    // at the time of sending (i.e. during the SMTP conversation).

    Get Create (RefClass(cComChilkatMailMan)) To hoMailman
    If (Not(IsComObjectCreated(hoMailman))) Begin
        Send CreateComObject of hoMailman
    End

    Set ComSmtpHost Of hoMailman To "outlook.office365.com"
    Set ComSmtpPort Of hoMailman To 587
    Set ComStartTLS Of hoMailman To True

    // Set the SMTP login/password
    Set ComSmtpUsername Of hoMailman To "OFFICE365-SMTP-LOGIN"
    Set ComSmtpPassword Of hoMailman To "OFFICE365-SMTP-PASSWORD"

    // Create a new email object
    Get Create (RefClass(cComChilkatEmail)) To hoEmail
    If (Not(IsComObjectCreated(hoEmail))) Begin
        Send CreateComObject of hoEmail
    End

    Set ComSubject Of hoEmail To "Testing for Chilkat API..."
    Set ComBody Of hoEmail To "Testing for Chilkat API..."
    Set ComFrom Of hoEmail To "Chilkat Support <my-office365-user@mydomain.com>"
    Get ComAddTo Of hoEmail "Chilkat Admin" "admin@chilkatsoft.com" To iSuccess
    Get ComAddTo Of hoEmail "Non-Existent Recipient 1" "nonexist1@something.com" To iSuccess
    Get ComAddTo Of hoEmail "Non-Existent Recipient 2" "nonexist2@gmail.com" To iSuccess
    // 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.
    Set ComAllOrNone Of hoMailman To False

    // 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.  
    Get pvComObject of hoEmail to vEmail
    Get ComSendEmail Of hoMailman vEmail To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoMailman To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get ComCloseSmtpConnection Of hoMailman To iSuccess
    If (iSuccess <> True) Begin
        Showln "Connection to SMTP server not closed cleanly."
    End

    Showln "Mail Sent!"

    // IMPORTANT:  This example uses the Office365 SMTP server.  However, Office365 does not 
    // reject any invalid emails, even for it's own domain.  This is common behavior.
    // The same is true for GMail.  In many cases, the recipient email addresses are silently
    // accepted by the SMTP server, even if known to be invalid.   

    // Using GetBadEmailAddrs would only make sense for server that explicilty rejects local recipients
    // known to be invalid.

    // Examine which email addresses were rejected by the SMTP server during the SMTP conversation. 
    // (i.e. during the SendEmail)
    Get ComGetBadEmailAddrs Of hoMailman To vBadAddrs
    If (IsComObject(vBadAddrs)) Begin
        Get Create (RefClass(cComCkStringArray)) To hoBadAddrs
        Set pvComObject Of hoBadAddrs To vBadAddrs
    End
    Get ComCount Of hoBadAddrs To iNumBadAddrs
    Move 0 To i
    While (i < iNumBadAddrs)
        Get ComGetString Of hoBadAddrs i To sTemp1
        Showln "Rejected recipient " i ": " sTemp1
        Move (i + 1) To i
    Loop

    Send Destroy of hoBadAddrs


End_Procedure