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>