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 SIMPHONEBOOKADDITIONALNUMBERstructure supports an additional phone number item associated with SIMPHONEBOOKENTRYEX. The SIMPHONEBOOKADDITIONALNUMBERstructure is part of the SIM Manager API set that enables access to information stored on the USIM card.

Syntax 

typedef struct simphonebookadditionalnumber_tag {
  DWORD 
cbSize;
  DWORD 
dwParams;
  TCHAR 
lpszAddress[MAX_LENGTH_ADDRESS];
  DWORD 
dwAddressType;
  DWORD 
dwNumPlan;
  DWORD 
dwNumId;
} SIMPHONEBOOKADDITIONALNUMBER, *LPSIMPHONEADDITIONALNUMBER;

Members

cbSize

Size of the structure in bytes.

dwParams

Indicates valid parameter values.

lpszAddress[MAX_LENGTH_ADDRESS]

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).
dwNumId

The additional number type tag.

Requirements

Header simmgr.h

See Also