2.2.1.2 Electronic Address Properties

The Contact object has built-in properties for up to three different email addresses (Email1, Email2, and Email3) and three different fax addresses (Primary Fax, Business Fax, and Home Fax). Each of these electronic addresses is optional, and each consists of a group of related properties associated with it.

Unless otherwise specified, when creating or modifying a Contact object, all properties in a group MUST be set, changed, or deleted together at the same time. Specifications of similar properties are grouped together in sections 2.2.1.2.1 through section 2.2.1.2.12. The following table specifies the properties in each Electronic Address group.

Group name

Description

Properties in group

Email1

Defines the first email address for a contact.

PidLidEmail1DisplayName (section 2.2.1.2.1)

PidLidEmail1AddressType (section 2.2.1.2.2)

PidLidEmail1EmailAddress (section 2.2.1.2.3)

PidLidEmail1OriginalDisplayName (section 2.2.1.2.4)

PidLidEmail1OriginalEntryId (section 2.2.1.2.5)

Email2

Defines the second email address for a contact.

PidLidEmail2DisplayName (section 2.2.1.2.1)

PidLidEmail2AddressType (section 2.2.1.2.2)

PidLidEmail2EmailAddress (section 2.2.1.2.3)

PidLidEmail2OriginalDisplayName (section 2.2.1.2.4)

PidLidEmail2OriginalEntryId (section 2.2.1.2.5)

Email3

Defines the third email address for a contact.

PidLidEmail3DisplayName (section 2.2.1.2.1)

PidLidEmail3AddressType (section 2.2.1.2.2)

PidLidEmail3EmailAddress (section 2.2.1.2.3)

PidLidEmail3OriginalDisplayName (section 2.2.1.2.4)

PidLidEmail3OriginalEntryId (section 2.2.1.2.5)

Primary Fax

Defines the primary fax address for a contact.

PidTagPrimaryFaxNumber (section 2.2.1.2.6)

PidLidFax1AddressType (section 2.2.1.2.7)

PidLidFax1EmailAddress (section 2.2.1.2.8)

PidLidFax1OriginalDisplayName (section 2.2.1.2.9)

PidLidFax1OriginalEntryId (section 2.2.1.2.10)

Business Fax

Defines the business fax address for a contact.

PidTagBusinessFaxNumber (section 2.2.1.2.6)

PidLidFax2AddressType (section 2.2.1.2.7)

PidLidFax2EmailAddress (section 2.2.1.2.8)

PidLidFax2OriginalDisplayName (section 2.2.1.2.9)

PidLidFax2OriginalEntryId (section 2.2.1.2.10)

Home Fax

Defines the home fax address for a contact.

PidTagHomeFaxNumber (section 2.2.1.2.6)

PidLidFax3AddressType (section 2.2.1.2.7)

PidLidFax3EmailAddress (section 2.2.1.2.8)

PidLidFax3OriginalDisplayName (section 2.2.1.2.9)

PidLidFax3OriginalEntryId (section 2.2.1.2.10)

If any of the email addresses are defined for the contact, then the properties PidLidAddressBookProviderArrayType (section 2.2.1.2.12) and PidLidAddressBookProviderEmailList (section 2.2.1.2.11) MUST be defined as well.

For each email address, if one property is defined, then the entire set of properties MUST be defined, and PidLidAddressBookProviderArrayType and PidLidAddressBookProviderEmailList MUST be defined as well.

If PidTagPrimaryFaxNumber, PidTagBusinessFaxNumber, or PidTagHomeFaxNumber is defined, then the PidLidAddressBookProviderArrayType and PidLidAddressBookProviderEmailList properties SHOULD be defined, as well as the rest of the Primary Fax, Business Fax, or Home Fax properties, respectively. The client sets the PidLidAddressBookProviderEmailList and PidLidAddressBookProviderArrayType and Primary Fax, Business Fax, or Home Fax properties only if the client is able to interpret the value of the PidTagPrimaryFaxNumber, PidTagBusinessFaxNumber, or PidTagHomeFaxNumber property, respectively, as an actual fax phone number. The server sets the PidLidAddressBookProviderEmailList and PidLidAddressBookProviderArrayType properties whenever the PidTagPrimaryFaxNumber, PidTagBusinessFaxNumber, or PidTagHomeFaxNumber property is set.<2>

Show: