SIMMESSAGE (Compact 2013)

3/26/2014

The SIMMESSAGE structure contains a SIM message entry. This structure is part of the SIM Manager API set that enables access to information stored on the SIM card.

Syntax

typedef struct simmessage_tag {
  DWORD cbSize;
  DWORD dwParams;
  TCHAR lpszAddress[MAX_LENGTH_ADDRESS];
  DWORD dwAddressType;
  DWORD dwNumPlan;
  SYSTEMTIME stReceiveTime;
  DWORD cbHdrLength;
  BYTE rgbHeader[MAX_LENGTH_HEADER];
  TCHAR lpszMessage[MAX_LENGTH_MESSAGE];
} SIMMESSAGE, FAR *LPSIMMESSAGE; 

Members

• cbSize
  Size of the structure in bytes.

• dwParams
  Indicates valid parameter values.

  Name	Value	Description
  SIM_PARAM_MSG_ADDRESS	0x00000001	lpszAddress field is valid
  SIM_PARAM_MSG_ADDRESS_TYPE	0x00000002	dwAddressType field is valid
  SIM_PARAM_MSG_NUMPLAN	0x00000004	dwNumPlan field is valid
  SIM_PARAM_MSG_RECEIVE_TIME	0x00000008	stReceiveTime field is valid
  SIM_PARAM_MSG_HEADER	0x00000010	rgbHeader field is valid
  SIM_PARAM_MSG_HEADER_LENGTH	0x00000020	cbHdrLength field is valid
  SIM_PARAM_MSG_MESSAGE	0x00000040	lpszMessage field is valid
  SIM_PARAM_MSG_ALL	0x0000007f	All fields are valid

• lpszAddress
  An array that contains the actual phone number.

• dwAddressType
  A SIM_ADDRTYPE constant, which defines the address space of the lpszAddress field.

  Name	Value	Description
  SIM_ADDRTYPE_UNKNOWN	0x00000000	Unknown.
  SIM_ADDRTYPE_INTERNATIONAL	0x00000001	International number.
  SIM_ADDRTYPE_NATIONAL	0x00000002	National/Regional number.
  SIM_ADDRTYPE_NETWKSPECIFIC	0x00000003	Network specific number.
  SIM_ADDRTYPE_SUBSCRIBER	0x00000004	Subscriber number (protocol-specific).
  SIM_ADDRTYPE_ALPHANUM	0x00000005	Alphanumeric address.
  SIM_ADDRTYPE_ABBREV	0x00000006	Abbreviated number.

• dwNumPlan
  A SIM_NUMPLAN constant, which defines the numbering plan when dwAddressType equals SIM_ADDRTYPE_UNKNOWN, SIM_ADDRTYPE_INTERNATIONAL, and SIM_ADDRTYPE_NATIONAL.

  Name	Value	Description
  SIM_NUMPLAN_UNKNOWN	0x00000000	Unknown.
  SIM_NUMPLAN_TELEPHONE	0x00000001	ISDN/telephone numbering plan (E.164/E.163).
  SIM_NUMPLAN_DATA	0x00000002	Data numbering plan (X.121).
  SIM_NUMPLAN_TELEX	0x00000003	Telex numbering plan.
  SIM_NUMPLAN_NATIONAL	0x00000004	National/Regional numbering plan.
  SIM_NUMPLAN_PRIVATE	0x00000005	Private numbering plan.
  SIM_NUMPLAN_ERMES	0x00000006	ERMES numbering plan (ETSI DE/PS 3 01-3).

• stReceiveTime
  Timestamp for the incoming message.

• cbHdrLength
  Header length in bytes.

• rgbHeader
  An array containing the actual header data.

• lpszMessage
  An array containing the actual message data.

Requirements

Header

simmgr.h

See Also

Reference

SIM Manager Structures
SimReadMessage
SimWriteMessage
SimDeleteMessage