Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The PIMPR_CONTACTTYPEenumeration contains values for the PIMPR_CONTACT_TYPEproperty—which identifies where a Contact item is from, either from the mobile device (the traditional source) or from the Subscriber Identity Module (SIM and USIM). For more information on the PIMPR_CONTACT_TYPEproperty, see Contact Property IDs.

Syntax

enum PIMPR_CONTACTTYPE {
  PIMPR_CONTACTTYPE_DEVICE  = 0,
  PIMPR_CONTACTTYPE_SIM	 = 1

};

Elements

PIMPR_CONTACTTYPE_DEVICE

The Contact item comes from the mobile device.

PIMPR_CONTACTTYPE_SIM

The Contact item comes from the SIM or USIM.

Remarks

You cannot synchronize SIM Contact items.

Your POOM code can process SIM Contact items (that is, Contact items with the PIMPR_CONTACT_TYPEvalue of PIMPR_CONTACTTYPE_SIM) as generic OlItemType::olContactItemPOOM items, but you must accommodate for the differences in their supported POOM properties. The POOM properties that are supported by SIM Contacts are determined by the SIM's phonebook capabilities. You can query a SIM for a list of its capabilities by calling the SimGetDevCapsfunction, and then using this information to control the behavior of your Contact processing code. For more information, see the SIM Manager Reference.

Universal SIMs (USIMs) are the next-generation (3G) Subscriber Identity Modules. Like SIMs, they employ Universal Integrated Circuit Card (UICC) SmartCard technology, but include advanced support for UMTS Mobile Telephony and expanded onboard memory capabilities.

Note:
Support for the advanced capabilities of 3G USIMs is not exposed to POOM in Windows Mobile. As far as POOM Contacts are concerned, USIM capabilities are equivalent to those of 2G SIMs.

Supported POOM Contact Properties

SIM Contact items support the properties listed in the following table. For more information, see Contact Property IDs.

Note:
You can always use Named Properties with SIM Contact items.

Always Supported Optionally Supported

PIMPR_CONTACT_TYPE

PIMPR_ASSISTANT_TELEPHONE_NUMBER

PIMPR_DISPLAY_NAME

PIMPR_BUSINESS_TELEPHONE_NUMBER

PIMPR_FILEAS

PIMPR_BUSINESS2_TELEPHONE_NUMBER

PIMPR_FIRST_NAME

PIMPR_CAR_TELEPHONE_NUMBER

PIMPR_FOLDER_CATEGORIES

PIMPR_COMPANY_TELEPHONE_NUMBER

PIMPR_FOLDERNOTIFICATIONS

PIMPR_EMAIL1_ADDRESS

PIMPR_INVALID_ID

PIMPR_EMAIL2_ADDRESS

PIMPR_OID

PIMPR_EMAIL3_ADDRESS

PIMPR_RECENT

PIMPR_FIRST_NAME

PIMPR_SMARTPROP

PIMPR_HOME_TELEPHONE_NUMBER

PIMPR_SMS

PIMPR_HOME2_TELEPHONE_NUMBER

PIMPR_SOURCE_ID

PIMPR_MOBILE_TELEPHONE_NUMBER

PIMPR_YOMI_FILEAS

PIMPR_NICKNAME

 

PIMPR_RADIO_TELEPHONE_NUMBER

Note:
Calls to IItem::SetPropswith properties other than those listed here, return an HRESULT value of E_NOTSUPPORTED.

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later, Windows Mobile 6 Standard and later

See Also