PIMPR_CONTACTTYPE (Compact 7)

3/12/2014

The PIMPR_CONTACTTYPE enumeration contains values for the PIMPR_CONTACT_TYPE property-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_TYPE property, see Contact Property ID's.

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_TYPE value of PIMPR_CONTACTTYPE_SIM) as generic OlItemType::olContactItem POOM items, but you must accommodate for the differences in their supported POOM properties. The POOM properties that are supported by SIM Contacts is determined by the SIM's phonebook capabilities. You can query a SIM for a list of its capabilities by calling the SimGetDevCaps function, 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.

Supported POOM Contact Properties

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

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::SetProps with properties other than those listed here, return an HRESULT value of E_NOTSUPPORTED.

Requirements

Header

pimstore.h

Library

Pimstore.lib

See Also

Reference

Pocket Outlook Object Model Enumerations
Pocket Outlook Object Model Property Identifiers
Contact Property ID's
IPOlItems3::IncludeSimContacts
IPOlItems3
OlItemType

Other Resources

SimGetDevCaps