SIMPHONEBOOKADDITIONALNUMBER (Compact 2013)

3/26/2014

This structure supports an additional phone number item associated with SIMPHONEBOOKENTRYEX. This structure 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.

  Name	Value	Description
  SIM_PARAM_ADDITIONALNUM_ADDRESS	0x00000001	lpszAddress field is valid
  SIM_PARAM_ADDITIONALNUM_ADDRESS_TYPE	0x00000002	dwAddressType field is valid
  SIM_PARAM_ADDITIONALNUM_NUMPLAN	0x00000004	dwNumPlan field is valid
  SIM_PARAM_ADDITIONALNUM_NUMID	0x00000008	dwNumId field is valid
  SIM_PARAM_ADDITIONALNUM_ALL	0x0000000F	ALL fields are valid

• 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/Regional 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/Regional numbering plan.
  SIM_NUMPLAN_PRIVATE	Private numbering plan.
  SIM_NUMPLAN_ERMES	ERMES numbering plan (ETSI DE/PS 3 01-3).

• dwNumId
  This is the SIM Alpha Identifier that provides Alpha-tagging of the associated dialing number.

Requirements

Header

simmgr.h

See Also

Reference

SIM Manager Structures