PowerBuilder

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.

PowerBuilder

integer li_rc
long li_Success
oleobject loo_Mailman
oleobject loo_Email
oleobject loo_BadAddrs
long li_NumBadAddrs
long i

li_Success = 0

//  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).

loo_Mailman = create oleobject
li_rc = loo_Mailman.ConnectToNewObject("Chilkat.MailMan")
if li_rc < 0 then
    destroy loo_Mailman
    MessageBox("Error","Connecting to COM object failed")
    return
end if

loo_Mailman.SmtpHost = "outlook.office365.com"
loo_Mailman.SmtpPort = 587
loo_Mailman.StartTLS = 1

//  Set the SMTP login/password
loo_Mailman.SmtpUsername = "OFFICE365-SMTP-LOGIN"
loo_Mailman.SmtpPassword = "OFFICE365-SMTP-PASSWORD"

//  Create a new email object
loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")

loo_Email.Subject = "Testing for Chilkat API..."
loo_Email.Body = "Testing for Chilkat API..."
loo_Email.From = "Chilkat Support <my-office365-user@mydomain.com>"
li_Success = loo_Email.AddTo("Chilkat Admin","admin@chilkatsoft.com")
li_Success = loo_Email.AddTo("Non-Existent Recipient 1","nonexist1@something.com")
li_Success = loo_Email.AddTo("Non-Existent Recipient 2","nonexist2@gmail.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.
loo_Mailman.AllOrNone = 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.  
li_Success = loo_Mailman.SendEmail(loo_Email)
if li_Success <> 1 then
    Write-Debug loo_Mailman.LastErrorText
    destroy loo_Mailman
    destroy loo_Email
    return
end if

li_Success = loo_Mailman.CloseSmtpConnection()
if li_Success <> 1 then
    Write-Debug "Connection to SMTP server not closed cleanly."
end if

Write-Debug "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)
loo_BadAddrs = loo_Mailman.GetBadEmailAddrs()
li_NumBadAddrs = loo_BadAddrs.Count
i = 0
do while i < li_NumBadAddrs
    Write-Debug "Rejected recipient " + string(i) + ": " + loo_BadAddrs.GetString(i)
    i = i + 1
loop
destroy loo_BadAddrs


destroy loo_Mailman
destroy loo_Email