C Style API
bbBounceCheck() Function

Checks an email message to see if it is, indeed, a bounced message. If all you need to do is check email messages for a bounce type, and extract the email address, then this is the only function you need.

long bbBounceCheck (strMessage, strEmailAddressOut, lEmailAddressLenOut, strEmailIgnoreList, strLicenseKey)



Parameters

strMessage

Null terminated character array containing the email message that you need to check for being a bounced message.

strEmailAddressOut [out]

Null terminated 255 character array. If the email message that is passed into strMessage is a bounce then this parameter will contain the email address of the bounced message.

lEmailAddressLenOut [out]

Returns a long value. Contains the length of the email address returned in strEmailAddressOut.

strEmailIgnoreList

Null terminated character array containing email addresses that BoogieBounce should ignore. More than likely, this will normally include your From and Reply-To email addresses for the particular POP account you are checking email for. This list of email addresses MUST be PIPE delimited. Please see example below:

"joe@joe.com|JoeReplyBox@joe.com"
The example above is made up of 2 email addresses. joe@joe.com and JoeReplyBox@joe.com.

strEmailIgnoreList isn't used by BoogieBounce in all cases. Sometimes BoogieBounce knows that a message is a bounce, but for some reason the email address of the recipient isn't in the position that BoogieBounce is expecting it to be. When this occurs, BoogieBounce does a deeper scan of the message to find the proper recipient email address. BoogieBounce doesn't want to pass back the From or Reply-To email address of the original sender by mistake, so it checks for this before returning the strEmailAddressOut email address back to you.

strLicenseKey

Null terminated character array containing your unlock code. This parameter is used when you purchase the BoogieBounce API. If you are demo'ing the BoogieBounce API, then leave this value as an empty string.


Syntax - (Visual Basic)

' ** Pad strEmailAddress out parameter with spaces.
strEmailAddress = String(255, " ")

' ** First, call bbBounceCheck
lBounceType = bbBounceCheck(strMessage, strEmailAddress, lEmailAddresslen, _
"joebob@joe.net|somereply@joe.net", "My Key/1234567890")

' ** Get Bounced Email Address
sEmailAddress = Left(strEmailAddress, lEmailAddressLen)


Return Values

Return CodeDescription
0UNDETERMINED - (i.e. Recipient Reply)
10HARD BOUNCE - (i.e. User Unknown)
20SOFT BOUNCE - General
21SOFT BOUNCE - Dns Failure
22SOFT BOUNCE - Mailbox Full
23SOFT BOUNCE - Message Too Large
30BOUNCE - NO EMAIL ADDRESS. VERY RARE!
40GENERAL BOUNCE
50MAIL BLOCK - General
51MAIL BLOCK - Known Spammer
52MAIL BLOCK - Spam Detected
53MAIL BLOCK - Attachment Detected
54MAIL BLOCK - Relay Denied
60AUTO REPLY - (i.e. Out Of Office)
70TRANSIENT BOUNCE
80SUBSCRIBE Request
90UNSUBSCRIBE/REMOVE Request
100CHALLENGE-RESPONSE



Remarks

If all you need to do is check email messages for a bounce type, and extract the email address, then this is the only function you need.

For more examples, and language specific declarations, see sample source code files that came with BoogieBounce API.


See Also

Visual Basic Users
Power Basic Users