RILMESSAGE (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/2010

This structure stores message data.

Syntax

typedef struct {
  DWORD cbSize;
  DWORD dwParams;
  RILADDRESS raSvcCtrAddress;
  DWORD dwType;
  DWORD dwFlags;
  UNION {
    struct {
            RILADDRESS raOrigAddress;
            DWORD dwProtocolID;
            RILMSGDCS rmdDataCoding;
            SYSTEMTIME stSCReceiveTime;
            DWORD cbHdrLength;
            DWORD cchMsgLength;
            BYTE rgbHdr[MAXLENGTH_HDR];
            BYTE rgbMsg[MAXLENGTH_MSG];
           } msgInDeliver;
    struct {
            DWORD dwTgtMsgReference;
            RILADDRESS raTgtRecipAddress;
            SYSTEMTIME stTgtSCReceiveTime;
            SYSTEMTIME stTgtDischargeTime;
            DWORD dwTgtDlvStatus;
            DWORD dwProtocolID;
            RILMSGDCS rmdDataCoding;
            DWORD cbHdrLength;
            DWORD cchMsgLength;
            BYTE rgbHdr[MAXLENGTH_HDR];
            BYTE rgbMsg[MAXLENGTH_MSG];
           } msgInStatus;
    struct {
            RILADDRESS raDestAddress;
            DWORD dwProtocolID;
            RILMSGDCS rmdDataCoding;
            DWORD dwVPFormat;
            SYSTEMTIME stVP;
            DWORD cbHdrLength;
            DWORD cchMsgLength;
            BYTE rgbHdr[MAXLENGTH_HDR];
            BYTE rgbMsg[MAXLENGTH_MSG];
           } msgOutSubmit;
    struct {
            DWORD dwProtocolID;
            DWORD dwCommandType;
            DWORD dwTgtMsgReference;
            RILADDRESS raDestAddress;
            DWORD cbCmdLength;
            BYTE rgbCmd[MAXLENGTH_CMD];
           } msgOutCommand;
    struct {
            DWORD dwGeoScope;
            DWORD dwMsgCode;
            DWORD dwUpdateNumber;
            DWORD dwID;
            RILMSGDCS rmdDataCoding;
            DWORD dwTotalPages;
            DWORD dwPageNumber;
            DWORD cchMsgLength;
            BYTE rgbMsg[MAXLENGTH_MSG];
           } msgBcGeneral;
    struct {
            DWORD cchMsgLength;
            BYTE rgbMsg[MAXLENGTH_MSG];
           } msgOutRaw;
    struct {
            RILADDRESS raOrigAddress;
            RILSUBADDRESS rsaOrigSubaddr;
            SYSTEMTIME stSCReceiveTime;
            SYSTEMTIME stValidityPeriodAbs;
            SYSTEMTIME stValidityPeriodRel;
            SYSTEMTIME stDeferredDelTimeAbs;
            SYSTEMTIME stDeferredDelTimeRel;
            DWORD dwNumMsgs;
            RILADDRESS raCallBackNumber; 
            DWORD dwMsgPriority; 
            DWORD dwMsgPrivacy;
            BOOL bUserAckRequest; 
            DWORD dwMsgDisplayMode;
            DWORD dwTeleservice; 
            DWORD dwMsgID;
            DWORD dwMsgLang;
            DWORD dwMsgEncoding;
            DWORD cchMsgLength;
            BYTE rgbMsg[MAXLENGTH_MSG];
           } msgIS637InDeliver;
    struct {
            RILADDRESS raDestAddress;
            RILSUBADDRESS rsaDestSubaddr;
            BOOL bDigit;
            SYSTEMTIME stValidityPeriodAbs;
            SYSTEMTIME stValidityPeriodRel;
            SYSTEMTIME stDeferredDelTimeAbs;
            SYSTEMTIME stDeferredDelTimeRel;
            BOOL bDeliveryAckRequest;
            BOOL bUserAckRequest;
            BOOL bBearerReplyRequest;
            DWORD dwReplySeqNumber;
            DWORD dwMsgDisplayMode;
            RILADDRESS raCallBackNumber;
            DWORD dwMsgPriority;
            DWORD dwMsgPrivacy;
            DWORD dwTeleservice;
            DWORD dwMsgID;
            DWORD dwMsgLang;
            DWORD dwMsgEncoding; 
            DWORD cchMsgLength;  
            BYTE rgbMsg[MAXLENGTH_MSG]; 
           } msgIS637OutSubmit;
    struct { 
            RILADDRESS raOrigAddress;
            RILSUBADDRESS rsaOrigSubaddr;
            SYSTEMTIME stSCReceiveTime;
            DWORD dwCauseCode;
            DWORD dwReplySeqNumber;
            DWORD dwUserResponseCode;
            DWORD dwMsgStatusType;
            DWORD dwMsgID;
            DWORD dwMsgLang;
            DWORD dwMsgEncoding;
            DWORD cchMsgLength;
            BYTE rgbMsg[MAXLENGTH_MSG];
           } msgIS637InStatus;
    struct {
            RILADDRESS raDestAddress;
            RILSUBADDRESS rsaDestSubaddr;
            BOOL bDigit;
            DWORD dwReplySeqNumber;
            DWORD dwUserResponseCode;
            DWORD dwMsgID;
            DWORD dwMsgLang;
            DWORD dwMsgEncoding;
            DWORD cchMsgLength;
            BYTE rgbMsg[MAXLENGTH_MSG];
           } msgIS637OutStatus;
        }
} RILMESSAGE;

Members

cbSize
Structure size, in bytes.

dwParams
Specifies valid parameters.

raSvcCtrAddress
Service center address.

dwType
Specifies the type of message. Must be one of the message type constants.

dwFlags
Specifies message flags. Must be one of the message flag constants.

raOrigAddress
Originating address.

dwProtocolID
Specifies message protocol. Must be one of the message protocol constants.

rmdDataCoding
Data coding scheme.

stSCReceiveTime
Service code receive time.

cbHdrLength
Length of message header, in bytes.

cchMsgLength
Length of message body, in bytes.

rgbHdr[MAXLENGTH_HDR]
Message header buffer.

rgbMsg[MAXLENGTH_MSG]
Message body buffer.

msgInDeliver
Incoming message delivery indicated by a RIL_MSGTYPE_IN_DELIVER constant.

dwTgtMsgReference
Specifies the target message reference.

raTgtRecipAddress
Address of the target recipient.

stTgtSCReceiveTime
Target recipient receive time.

stTgtDischargeTime
Target recipient discharge time.

dwTgtDlvStatus
Specifies target delivery status.

msgInStatus
Incoming status message indicated by a RIL_MSGTYPE_IN_STATUS constant.

raDestAddress
Destination address.

dwVPFormat
Specifies the validity period format.

stVP
Validity period. Must be one of the message validity constants.

msgOutSubmit
Outgoing message indicated by a RIL_MSGTYPE_OUT_SUBMIT constant.

dwCommandType
Specifies the command type.

cbCmdLength
Length of the command, in bytes.

rgbCmd[MAXLENGTH_CMD]
Command buffer.

msgOutCommand
Outgoing command message indicated by a RIL_MSGTYPE_OUT_COMMAND constant.

dwGeoScope
Specifies the geographic scope of the message. Must be one of the message geographic constants.

dwMsgCode
Specifies the message code.

dwUpdateNumber
Specifies the update number.

dwID
Specifies the identifier.

dwTotalPages
Specifies the total number of pages.

dwPageNumber
Specifies the current page number.

msgBcGeneral
Broadcast message indicated by a RIL_MSGTYPE_BC_GENERAL constant.

msgOutRaw
Outgoing raw message as indicated by a RIL_MSGTYPE_OUT_RAW constant.

rsaOrigSubaddr
Origination subaddress.

stValidityPeriodAbs
Absolute validity period time.

stValidityPeriodRel
Relative validity period time.

stDeferredDelTimeAbs
Absolute deferred delivery time.

stDeferredDelTimeRel
Relative deferred delivery time.

dwNumMsgs
Specifies the number of messages on voicemail. This member is valid for voicemail only.

raCallBackNumber
Message callback number. The callback number is only valid for paging and text messages.

dwMsgPriority
Message priority. Must be one of the message priority class constants.

dwMsgPrivacy
Message privacy level. Must be one of the message privacy class constants.

bUserAckRequest
If this member is set to 0, end-user acknowledgement is not requested. If this member is set to 1, end-user acknowledgement is requested.

dwMsgDisplayMode
Specifies the message display mode. Must be one of the message display mode constants.

dwTeleservice
Specifies the message teleservice. Must be one of the message teleservice constants. This member is mandatory.

dwMsgID
Specifies the message ID (1-65535).

dwMsgLang
Specifies the message language.

dwMsgEncoding
Specifies the message encoding type. Must be one of the message encoding constants.

rsaDestSubaddr
Destination address.

bDigit
If this member is set to 0, the RILADDRESS structure is in 4-bit mode. If this member is set to 1, RILADDRESS is in 8-bit mode. The default value for this member should be 1.

bDeliveryAckRequest
If this member is set to 0, delivery acknowledgement is not requested. If this member is set to 1, delivery acknowledgement is requested.

bBearerReplyRequest
If this member is set to 0, bearer reply is not requested. If this member is set to 1, bearer reply is requested.

dwReplySeqNumber
Specifies the sequence number of the message being replied to, typically the message ID.

dwCauseCode
Specifies the cause code.

dwUserResponseCode
Specifies the user response code. This member is a carrier-specific code for responding to a user acknowledgement.

dwMsgStatusType
Specifies the message status type. Must be one of the message status type constants.

Requirements

Header	ril.h
Windows Embedded CE	Windows CE .NET 4.2 and later

Share via

RILMESSAGE (Windows Embedded CE 6.0)

Syntax

Members

Requirements

See Also

Reference

Additional resources