SIMPHONEBOOKENTRY (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

SIM Manager Structures
SimReadPhonebookEntry
SimWritePhonebookEntry
SimDeletePhonebookEntry