SIMPHONEBOOKENTRY
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