Reference Guide - Melissa Data

Email Object FunctionsEmail Object• Standardize Casing - Email Object can also switch all alphabetic characters in the email address tolower case, assuming that the value passed to the SetStandardizeCasing function is TRUE.• Result Codes - Check the output of the GetResults function (page 19) after calling VerifyEmail.Result codes indicate the validity of the submitted email address, the reason for any errors, and anychanges made to correct the submitted address.• Configuration Files - Email Object’s syntax correction, domain updating, and domain verificationroutines can be overridden via the mdEmail.cfg file. This is a plain text file, which allows you to add,remove, or override some of Email Object’s default mdEmail.dat tables.• See Modifying Settings for Email Object on page 19 for more information on modifying this file.Input ParametersThis function has one input parameter, a string containing the complete email address that you wish toverify and, optionally, correct and update.Return ValueThis function returns TRUE if the email address, including any corrections, is valid. Returns FALSE ifnot.SyntaxCCOMBooleanValue = object->VerifyEmail(StringValue);IntegerValue = mdEmailVerifyEmail(object, char*);BooleanValue = object.VerifyEmail(StringValue)Retrieve the Status InformationThe following functions return general information about the success or failure of the last call to theVerifyEmail function.GetResultsThis function returns a comma-delimited string of four-character codes which detail the level ofmatching found for the current email address and any errors that occurred during the last call to theVerifyEmail function.This is intended to replace the GetStatusCode and GetErrorCode functions, providing a single sourceof information about the last VerifyEmail call and eliminating the need to call multiple functions todetermine if a particular email address was verified.The function returns one or more of the following codes in a comma-delimited list.12