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 SIMMESSAGEstructure 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.

lpszAddress

An array that contains the actual phone number.

dwAddressType

A SIM_ADDRTYPE constant.

Value Description

SIM_ADDRTYPE_UNKNOWN

Unknown.

SIM_ADDRTYPE_INTERNATIONAL

International number.

SIM_ADDRTYPE_NATIONAL

0ne 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).
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
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also