Error property

Type: Long, read-only

Error code from the last Validate call. After Validate returns, this property remains unchanged until the next call.

A non-zero error code does not necessarily indicate a bad email address. Many of the possible errors come from network problems or other operational issues that say nothing about the validity of the address. Only a Validate return value of hexVeLevelBad (0) means that the address is bad.

License errors

Connection will initialize the Error property with one of the license-related errors (listed below under all stages) if the evaluation period has not expired (see Expires) or there is a problem with the license.

Error codes listed by validation stage

Below are the error codes possible at each validation stage. Possible error values for a given validation level include the errors for each stage included in that level. For instance, DNS-level validation could return errors for the Syntax, DNS, and "All" stages.

All stages

hexVeErrSuccess (0)

No error occurred.

hexVeErrLicenseFileNotFound (2)

This is the normal error during the evaluation period. If you see this after purchasing a license, make sure the license file is in the same directory as the component.

hexVeErrCouldNotOpenLicenseFile (3)

The license file was found but could not be opened for reading. Make sure the license file permissions are the same as those of the component.

hexVeErrCorruptLicenseFile (4)

The license file has been modified in some way. Restore your backup version or obtain a new copy from Hexillion.

hexVeErrWrongProductLicense (5)

The component is not the product named in the license file. License files can only be used with the products for which they were created.

hexVeErrWrongVersionLicense (6)

The license file was not created for this version of the component.

hexVeErrUnlicensedProcessors (7)

The component is executing on a machine with more processors than the license file allows.

hexVeErrUnexpected (536870912)

Something went wrong that the HexValidEmail component did not expect. This could indicate a problem with your network stack or with the component itself, so you may want to contact Hexillion if you get this error.

Syntax stage

hexVeErrAddrTooLong (536870913)

The address to be validated was greater than 256 characters long.

hexVeErrExtraTextPresent (536870914)

Extra text is present in the address, and  hexVeOptionAllowExtraText is not part of Options.

hexVeErrIllegalChar (536870915)

The email address contains an illegal character.

hexVeErrUnbalancedParenthesis (536870916)

The email address contains a parenthesis character ('(' or ')') that is not part of a matched pair.

hexVeErrUnbalancedSquareBracket (536870917)

The email address contains a square bracket character ('[' or ']') that is not part of a matched pair.

hexVeErrUnbalancedAngleBracket (536870918)

The email address contains an angle bracket character ('<' or '>') that is not part of a matched pair.

hexVeErrQuotationMarksNotClosed (536870919)

The email address contains a quotation mark character ('"') that is not part of a matched pair.

hexVeErrDomainLiteralPresent (536870920)

The address contains a domain literal, but Options contains hexVeDisallowDomainLiterals.

hexVeErrMisplacedDomainLiteral (536870921)

The email address contains a domain literal that is in an invalid place.

hexVeErrMisplacedQuotedString (536870922)

The email address contains a quoted string that is in an invalid place.

hexVeErrNoLocalPart (536870923)

The email address lacks a local part, that is, the part just before the '@' character.

hexVeErrNoDomain (536870924)

The email address lacks a domain name just after the '@' character.

hexVeErrInvalidDomain (536870925)

The email address contains an invalid domain name.

hexVeErrInvalidDomainLiteral (536870926)

The email address contains an invalid domain literal.

hexVeErrNoAddrSpecified (536870932)

The address passed to Validate was empty.

DNS stage

hexVeErrAddressNotAvailable (10049)

This probably indicates that one or more DNS server addresses specified in your machine's TCP/IP properties or the registry are not valid.

hexVeErrNetworkDown (10050)

Your local machine's network connection is down or blocked by a personal firewall.

hexVeErrNetworkUnreachable (10051)

The DNS servers are unreachable.

hexVeErrTimedOut (10060)

Connection did not receive a response from the DNS servers within the time limit specified by Timeouts(hexVeTimeoutDnsTotal).

hexVeErrConnectionRefused (10061)

Connection was refused access to the DNS servers. This may be the result of firewall interference, or perhaps the machines specified as DNS servers aren't actually running DNS server software on the standard UDP port 53.

hexVeErrHostUnreachable (10065)

The DNS servers are unreachable.

hexVeErrTryAgain (11002)

The DNS servers returned an unspecific error that suggests trying again.

hexVeErrNoRecovery (11003)

The DNS servers returned an unspecific, unrecoverable error.

hexVeErrNoData (11004)

The DNS servers returned a valid response that contained no records.

hexVeErrNoDnsServerConfigured (536870927)

The machine on which the component is running does not have DNS servers listed in its TCP/IP properties. At least one server must be listed for DNS-level validation.

hexVeErrDomainDoesNotExist (536870928)

The email address' domain does not exist in the DNS. If you got this error but you know that the domain does exist in the public DNS, then your local DNS servers or firewall may not be configured to allow resolution of external domains.

hexVeErrNoMxForDomain (536870929)

The email address' domain does exist but has no MX (mail exchange) records.

SMTP stage

hexVeErrNetworkDown (10050)

Your local machine's network connection is down or blocked by a personal firewall.

hexVeErrNetworkUnreachable (10051)

The SMTP servers are unreachable.

hexVeErrConnectionAborted (10053)

The local machine's TCP/IP stack prematurely aborted an SMTP connection for some reason.

hexVeErrConnectionReset (10054)

A remote SMTP server prematurely aborted an SMTP connection for some reason.

hexVeErrTimedOut (10060)

Connection did not receive a response from the SMTP servers within the time limit specified by Timeouts(hexVeTimeoutSmtpTotal).

hexVeErrConnectionRefused (10061)

Connection was refused access to the SMTP servers. This may be the result of firewall interference, or perhaps the machines specified as SMTP servers aren't actually running SMTP server software on the standard TCP port 25.

hexVeErrHostUnreachable (10065)

The SMTP servers are unreachable.

hexVeErrHostNotFound (11001)

The domain names specified as SMTP servers in the MX records did not actually exist in the DNS.

hexVeErrTryAgain (11002)

The DNS servers returned an unspecific error that suggests trying again.

hexVeErrNoRecovery (11003)

The DNS servers returned an unspecific, unrecoverable error.

hexVeErrNoData (11004)

The DNS servers returned a valid response that contained no records.

hexVeErrCouldNotVerifyRecipient (536870930)

Some problem talking to the SMTP server prevented checking the recipient. Trying again may or may not help. Take a look at the SmtpSession to find out what happened.

hexVeErrRecipientRejected (536870931)

The SMTP server returned an error code after the RCPT command, indicating that it cannot receive mail for the recipient.

hexVeErrMailboxFull (536870933)

The SMTP server indicated that it cannot forward email to the specified address because the mailbox is full. This usually indicates the address does exist, but any email sent to this address in the near future will bounce.

hexVeErrBogusMxRecords (536870934)

MX records for the email address domain do not have valid IP addresses.

hexVeErrSenderBlocked (536870935)

The SMTP server is blocking email from you, perhaps based on your HELO domain, MAIL FROM address, or IP address. Your IP address may  be on an anti-spam blacklist. Take a look at the SmtpSession to find out what happened.

hexVeErrDetectedCatchAll (536870936)

The SMTP server accepts any address and does not reject bad ones. SMTP validation using this server will not yield meaningful results.

Rejection errors

Though only a Validate return value of hexVeLevelBad (0) means that an address is bad, these are the error codes normally associated with address rejections:

• all syntax errors
• hexVeErrDomainDoesNotExist (536870928)
• hexVeErrNoMxForDomain (536870929)
• hexVeErrRecipientRejected (536870931)
• hexVeErrBogusMxRecords (536870934)