Supported +contact keys

The information about a contact is represented as keys. Each key corresponds +to a specific piece of information, such as first name, last name, home phone +number, or email address. Each contact has at least one key. The supported +set of keys depends on the contacts database. If you try to add a key to a +database that does not support it, the Add method +returns an error message.

The following table lists the combined set of keys supported by databases +compatible with S60 5th Edition:

The default device database (URI: cntdb://c:contacts.cdb) +supports all the listed keys.
The SIM card database (URI: sim://global_adn) +supports a subset of the listed keys. The supported keys are indicated in +the Supported by SIM column.

In JavaScript, keys are represented as objects, with the key name as +the object name. For example, the ReturnValue iterator +returned by a GetList call might contain the following +keys (objects) for the first contact item:

ReturnValue[0].FirstName
ReturnValue[0].LastName
ReturnValue[0].LandPhoneHome
+
ReturnValue[0].EmailHome

Note: The SyncClass key is added to a contact by default, +with the Label property set to "Synchronisation" and +the Value property to "private", +unless specified as "public". Values other than "private" or "public" are +stored as "private".

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

**Table:** Contact keys
+ Key +	+ Description +	+ Maximum length +	+ Supported by SIM +
+ `LastName` +	+ Last name +	+ 50 (14 for SIM) +	+ X +
+ `FirstName` +	+ First name +	+ 50 +
+ `Prefix` +	+ Name prefix +	+ 10 +
+ `Suffix` +	+ Name suffix +	+ 10 +
+ `SecondName` +	+ Second name +	+ 50 +
+ `LandPhoneHome` +	+ Home land phone number +	+ 48 +
+ `MobilePhoneHome` +	+ Home mobile phone number +	+ 48 +
+ `VideoNumberHome` +	+ Home video number +	+ 48 +
+ `FaxNumberHome` +	+ Home fax number +	+ 48 +
+ `VoipHome` +	+ Home VoIP phone number +	+ 100 +
+ `EmailHome` +	+ Home email address +	+ 150 +
+ `URLHome` +	+ Home URL +	+ 1000 +
+ `AddrLabelHome` +	+ Home address label +	+ 250 +
+ `AddrPOHome` +	+ Home address post office +	+ 20 +
+ `AddrEXTHome` +	+ Home address extension +	+ 50 +
+ `AddrStreetHome` +	+ Home address street +	+ 50 +
+ `AddrLocalHome` +	+ Home address local +	+ 50 +
+ `AddrRegionHome` +	+ Home address region +	+ 50 +
+ `AddrPostCodeHome` +	+ Home address postal code +	+ 20 +
+ `AddrCountryHome` +	+ Home address country +	+ 50 +
+ `JobTitle` +	+ Job title +	+ 50 +
+ `CompanyName` +	+ Company name +	+ 50 +
+ `LandPhoneWork` +	+ Work land phone number +	+ 48 +
+ `MobilePhoneWork` +	+ Work mobile phone number +	+ 48 +
+ `VideoNumberWork` +	+ Work video number +	+ 48 +
+ `FaxNumberWork` +	+ Work fax number +	+ 48 +
+ `VoipWork` +	+ Work VoIP phone number +	+ 100 +
+ `EmailWork` +	+ Work email address +	+ 150 +
+ `URLWork` +	+ Work URL +	+ 1000 +
+ `AddrLabelWork` +	+ Work address label +	+ 250 +
+ `AddrPOWork` +	+ Work address post office +	+ 20 +
+ `AddrEXTWork` +	+ Work address extension +	+ 50 +
+ `AddrStreetWork` +	+ Work address street +	+ 50 +
+ `AddrLocalWork` +	+ Work address local +	+ 50 +
+ `AddrRegionWork` +	+ Work address region +	+ 50 +
+ `AddrPostCodeWork` +	+ Work address postal code +	+ 20 +
+ `AddrCountryWork` +	+ Work address country +	+ 50 +
+ `LandPhoneGen` +	+ General land phone number +	+ 48 +
+ `MobilePhoneGen` +	+ General mobile phone number +	+ 48 +	+ X +
+ `VideoNumberGen` +	+ General video number +	+ 48 +
+ `FaxNumberGen` +	+ General fax number +	+ 48 +
+ `VOIPGen` +	+ General VoIP phone number +	+ 100 +
+ `POC` +	+ Push to Talk over Cellular (PoC) +	+ 100 +
+ `SWIS` +	+ "See What I See" (SWIS) +	+ 100 +
+ `SIP` +	+ SIP identity +	+ 100 +
+ `EmailGen` +	+ General email address +	+ 150 +
+ `URLGen` +	+ General URL +	+ 1000 +
+ `AddrLabelGen` +	+ General address label +	+ 250 +
+ `AddrPOGen` +	+ General address post office +	+ 20 +
+ `AddrExtGen` +	+ General address extension +	+ 50 +
+ `AddrStreetGen` +	+ General address street +	+ 50 +
+ `AddrLocalGen` +	+ General address local +	+ 50 +
+ `AddrRegionGen` +	+ General address region +	+ 50 +
+ `AddrPostCodeGen` +	+ General address postal code +	+ 20 +
+ `AddrCountryGen` +	+ General address country +	+ 50 +
+ `PageNumber` +	+ Pager number +	+ 48 +
+ `DTMFString` +	+ DTMF string +	+ 60 +
+ `Date` +	+ Date +	+ This key is in TTime format. +
+ `Note` +	+ Note +	+ 1000 +
+ `Ringtone` +	+ Ring tone +	+ 256 +
+ `MiddleName` +	+ Middle name +	+ 50 +
+ `Department` +	+ Department name +	+ 50 +
+ `AsstName` +	+ Assistant name +	+ 50 +
+ `Spouse` +	+ Spouse name +	+ 50 +
+ `Children` +	+ Children +	+ 50 +
+ `AsstPhone` +	+ Assistant phone number +	+ 50 +
+ `CarPhone` +	+ Car phone number +	+ 48 +
+ `Anniversary` +	+ Anniversary +	+ This key is in TTime format. +
+ `SyncClass` +	+ Synchronisation + Possible values: + + `"Public"` + `"Private"` + + Any other value is interpreted as `"Private"`. +	+ 1000 +
+ `LOCPrivacy` +	+ Locality privacy +	+ 256 +