Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The SIMPHONEBOOKENTRYstructure 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.

NoteThe 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