SIMPHONEBOOKENTRY (Compact 2013)

  • Article

3/26/2014

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 and USIM cards.

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.

    Name

    Value

    Description

    SIM_PARAM_PBE_ADDRESS

    0x00000001

    lpszAddress field is valid

    SIM_PARAM_PBE_ADDRESS_TYPE

    0x00000002

    dwAddressType field is valid

    SIM_PARAM_PBE_NUMPLAN

    0x00000004

    dwNumPlan field is valid

    SIM_PARAM_PBE_TEXT

    0x00000008

    lpszText field is valid

    SIM_PARAM_PBE_ALL

    0x0000000F

    All fields are valid
  • lpszAddress
    An array for the actual phone number.

  • dwAddressType
    A SIM_ADDRTYPE constant.

    Name

    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/Regional 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.

    Name

    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/Regional 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

See Also

Reference

SIM Manager Structures
SimReadPhonebookEntry
SimWritePhonebookEntry
SimDeletePhonebookEntry