Share via


SIMPHONEBOOKENTRY

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The SIMPHONEBOOKENTRY structure supports a SIM phonebook entry. This structure is part of the SIM Manager API set that enables access to information stored on the SIM card.

Syntax

typedef struct simphonebookentry_tag {
  DWORD cbSize;
  DWORD dwParams;
  TCHAR lpszAddress[MAX_LENGTH_ADDRESS];
  DWORD dwAddressType;
  DWORD dwNumPlan;
  TCHAR lpszText[MAX_LENGTH_PHONEBOOKENTRYTEXT];
} SIMPHONEBOOKENTRY, *LPSIMPHONEBOOKENTRY;

Members

  • cbSize
    Size of the structure in bytes.
  • dwParams
    Indicates valid parameter values.

    Value Description

    SIM_PARAM_PBE_ADDRESS

    0x00000001

    SIM_PARAM_PBE_ADDRESS_TYPE

    0x00000002

    SIM_PARAM_PBE_NUMPLAN

    0x00000004

    SIM_PARAM_PBE_TEXT

    0x00000008

    SIM_PARAM_PBE_ALL

    0x0000000f

  • lpszAddress
    An array for the actual phone number.
  • dwAddressType
    A SIM_ADDRTYPE constant.

    Value Description

    SIM_ADDRTYPE_UNKNOWN

    Unknown.

    SIM_ADDRTYPE_INTERNATIONAL

    International number.

    Note The address should be prefixed with a "+" (plus sign), if not already, before being displayed to the user. Likewise, when writing an entry to the SIM, this needs to be written correctly.

    SIM_ADDRTYPE_NATIONAL

    National number.

    SIM_ADDRTYPE_NETWKSPECIFIC

    Network specific number.

    SIM_ADDRTYPE_SUBSCRIBER

    Subscriber number (protocol-specific).

    SIM_ADDRTYPE_ALPHANUM

    Alphanumeric address.

    SIM_ADDRTYPE_ABBREV

    Abbreviated number.

  • dwNumPlan
    A SIM_NUMPLAN constant.

    Value Description

    SIM_NUMPLAN_UNKNOWN

    Unknown.

    SIM_NUMPLAN_TELEPHONE

    ISDN/telephone numbering plan (E.164/E.163).

    SIM_NUMPLAN_DATA

    Data numbering plan (X.121).

    SIM_NUMPLAN_TELEX

    Telex numbering plan.

    SIM_NUMPLAN_NATIONAL

    National numbering plan.

    SIM_NUMPLAN_PRIVATE

    Private numbering plan.

    SIM_NUMPLAN_ERMES

    ERMES numbering plan (ETSI DE/PS 3 01-3).

  • lpszText
    An array for the text associated with the entry.

Requirements

Header simmgr.h
Library cellcore.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

SimReadPhonebookEntry
SimWritePhonebookEntry
SimDeletePhonebookEntry