![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
Section Contents
TSms |
Abstraction: SMS messaging |
etelbgsm.h
etelgsm.lib
This class defines the SMS message abstraction. The class manipulates SMS messages in the PDU message format and the Text message format.
This class is not intended for user derivation.
TSms();
The default C++ constructor constructs an empty PDU SMS message.
TSms(const TFormat aFormat);
The C++ constructor constructs an empty SMS message, taking the format PDU or Text from the argument.
const TFormat aFormat |
The format of the SMS message; PDU or Text. |
TSms(const TPdu& aPdu);
The C++ constructor builds a PDU format message, taking the message information from the argument.
const TPdu& aPdu |
The PDU format message. |
TSms(const TSubmit& aText);
The C++ constructor builds a text format message for sending i.e. a message of the submit type.
const TSubmit& aText |
The text format message. |
TSms(const TCommand& aCommand);
The C++ constructor builds a text format message containing an SMS command.
const TCommand& aCommand |
The SMS command. |
void SetFormat(const TFormat aFormat);
This function changes the format of the SMS message.
const TFormat aFormat |
The new format of the SMS message; PDU or text. |
void SetUseDefaultSca(const TBool& aUseDefaultSca);
This function defines whether or not the message uses the default Service Centre Address.
const TBool& aUseDefaultSca |
If true, use the default service centre address. |
void SetPduL(const TPdu& aPdu);
This function copies PDU message data into the TSms object.
const TPdu& aPdu |
The PDU format message. |
void SetTextL(const TSubmit& aText);
This function copies Text submit message data into the TSms object.
const TSubmit& aText |
The Text submit format message. |
void SetTextL(const TCommand& aCommand);
This function copies Text Command message data into the TSms object.
const TCommand& aCommand |
The Text command message |
TFormat Format() const;
This function returns the current format of the message.
The current message format; PDU or Text. |
TBool UseDefaultSca() const;
This function returns the current status of whether the message uses the default service centre address.
TBool |
If true, the message is set to used the default service centre address. |
const TPdu& PduL() const;
This function returns a reference to the contents of a PDU message.
TPdu& |
On return, contains a reference to the contents of the PDU message. |
TType TypeL() const;
This function returns the type of a message.
TType |
On return, contains the message type. |
const TDeliver& DeliverL() const;
This function returns a reference to the contents of a deliver text message.
On return, contains a reference to the contents of the received text deliver message. |
const TStatusReport& StatusReportL() const;
This function returns a reference to the contents of a status report text message.
On return, contains a reference to the contents of the received Text status report. |
const TCommand& CommandL() const;
This function returns a reference to the contents of a command text message.
On return, contains a reference to the contents of the received command. |
const TSubmit& SubmitL() const;
This function returns a reference to the contents of a submit text message.
On return, contains a reference to the contents of the received submit text message. |
The message is in PDU format. |
|
The message is in Text format. |
PDU format message. |
|
Text message received from network. |
|
Text status report |
|
Text command. |
|
Text message submitted to network. |
Size of the PDU message structure (428). |
Size of the text message structure (160). |
Size of the time stamp structure (22). |
The text submit message structure describes a message that has been submitted to the network.
TGsmTelNumber iDestinationAddr |
The messages destination address. |
TPid iPid |
A parameter identifying the higher protocol layer. |
TDcs iDcs |
The data coding scheme associated with the message. See ETSI GSM 03.38 |
TTimeStamp iValidityPeriod |
How long the message is valid (from hours up to 63 weeks). |
TGsmTelNumber iServiceCentreAddr |
The address of the service centre to which the message should be sent. This is network provider specific. |
TBuf8<KTextSize> iText |
The actual message. |
The text deliver message structure describes a message that has been received from the network.
TGsmTelNumber iOriginatingAddr |
The messages originating address. |
TTimeStamp iTimeStamp |
A message time and date stamp indicating when the service centre received the message. |
TPid iPid |
A parameter identifying the higher protocol layer. |
TDcs iDcs |
The data coding scheme associated with the message. |
TGsmTelNumber iServiceCentreAddr |
The originating service centre address. |
TBuf8<KTextSize> iText |
The actual message. |
The text status report message structure describes a report, generated by the network, about a message that has been submitted to the network.
TUint32 iMessageRef |
Identifier of the original message, sent previously, for which this is a status report. |
TGsmTelNumber iRecipientAddr |
Address of the recipient of the original message. |
TTimeStamp iTimeStamp |
Time stamp of when the service centre originally received the original message. |
TTimeStamp iDischargeTime |
Time stamp of when this status information was generated. |
TUint iStatus |
An integer identifying the status of the originally submitted message (see GSM 03.40 for details). |
The text command message structure describes a command submitted to the network.
TUint iCommandType |
Specifies the command to be performed by the network. |
TPid iPid |
A parameter identifying the higher protocol layer. |
TUint iMessageNumber |
Indicates the message reference number of the message to operate upon. |
TGsmTelNumber iDestinationAddr |
Destination address of the command. |
TBuf8<KTextSize> iCommand |
The actual command data. |
typedef TBuf8<KPduSize> TPdu;
Objects of this type are used to pass PDU formatted messages into SMS message objects (TSms).
typedef TBuf8<KTimeStampSize> TTimeStamp;
Objects of this type are used to pass time stamps into SMS message objects (TSms).
typedef TUint8 TPid;
Objects of this type are used to define the higher level protocol associated with an SMS message.
typedef TUint8 TDcs;
Objects of this type define the data coding scheme associated with an SMS message.
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |