Elements Argument

Using the nomenclature of RFC 822, an address has the following four-element format:

phrase <@route:local-part@domain>

The @route: element is referred to as a source route and is rarely seen.

An example address with all four elements is:

Judy Smith <@siroe.com:judy.smith@email.siroe.com>

The elements argument is a bitmask indicating which of these elements to return. The bitmask is formed by a logical OR of the following symbolic constants defined in the mtasdk.h header file:

• MTA_ADDR_PHRASE– In the example, the phrase part is Judy Smith.

• MTA_ADDR_ROUTE– In the example, the route part is @siroe.com.

• MTA_ADDR_LOCAL– In the example, the local part is judy.smith.

• MTA_ADDR_DOMAIN– In the example, the domain part is email.siroe.com.

For example, to select just the local and domain parts, use the following value for the elements argument:

MTA_ADDR_LOCAL | MTA_ADDR_DOMAIN

When a value of zero is supplied for elements the following default bitmask is assumed:

MTA_ADDR_ROUTE | MTA_ADDR_LOCAL | MTA_ADDR_DOMAIN