SIMMESSAGE (Compact 2013)

  • Article

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