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