Using the nomenclature of RFC 822, an address has the following four-element format:
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:email@example.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