At least one contacts database is available in S60 and
Series 40 devices, but it is common to have two databases
- one for the contact list in the main memory and another for contacts in
the SIM card. More databases might be available, depending on the device.
These databases can be selected by name with the openPIMList(int
pimListType, int mode, String name) method. The names used to identify
the database correspond to the localized name used by the device, and it is
possible in certain cases that they could even be user defined. Therefore,
the name should not be hard coded in the application; instead, it should be
obtained with the listPIMLists method. The order of the
database names returned by the listPIMLists method is
also the preferred order in the device. Commonly, there are two databases
that may be used. The first is the "in-memory" database, which is used by
default, and the second is the list in the SIM card. The approach to open
the default database is to either call openPIMList(int pimListType,
int mode) or pick the first entry from listPIMLists and
call openPIMList(int pimListType, int mode, String name)
For the supported fields and attributes, see PIM API Implementation notes.