email1 Field

[This is preliminary documentation and subject to change.]

The primary email address of the contact.

Full Name

urn:schemas:contacts:email1

Name Constant

CdoContacts.cdoEmail1Address

Variant SubType

[Visual Basic] String

[C++] BSTR

OLE DB Type

DBTYPE_WSTR

Remarks

This entry is also available as the IPerson::Email property.

This field has multiple purposes:

• As a mail attribute to hold the "primary SMTP address" - single valued.
• As a multi-valued proxyAddresses attribute to hold the full list of addresses for routing, queried for Sender address. Note that each email address stored in this attribute is prefixed by an address type identifier, such as SMTP or X400, followed by a colon (:). If the address type identifier is in all uppercase, that identifier is the primary address of this type, and consequently should be used as a default reply address. There can be only one primary address per address type.
• As a single-valued textEncodedORAddress to hold the primary X.400 address.
• As a single-valued targetAddress to hold the primary routing address for contacts (formerly CRs) used for routing.

Example

"mailto:Someone@Somewhere.microsoft.com"