Share via


SIMPHONEBOOKENTRY

Send Feedback

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.

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.

  • 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

Smartphone: Smartphone 2002 and later
Pocket PC: Pocket PC 2002 and later
OS Versions: Windows CE 3.0 and later
Header: simmgr.h
Library: cellcore.lib

See Also

SimReadPhonebookEntry, SimWritePhonebookEntry, SimDeletePhonebookEntry

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.