<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE reference

  PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

<reference id="GUID-2D9B17E7-2B7A-5E16-AB06-D9507457A85D" xml:lang="en"><title>smsexample:

SMS example</title><shortdesc>This example code demonstrates how to send and receive

SMS messages using the Messaging Framework APIs. </shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody>

<section id="GUID-81E46301-8C03-5C36-B601-804D25C7C927"><title>Purpose</title> <p>These

are the use cases demonstrated in this example: </p> <ul>

<li id="GUID-39FDC2E5-2B51-5884-95CD-A8E4DB557D23"><p>How to create an SMS

service. </p> </li>

<li id="GUID-E6031880-AFF1-5BE2-844E-8D6C5584D462"><p>How to create an SMS. </p> </li>

<li id="GUID-D9F4BEFD-02EF-5108-99B4-E96003655A3B"><p>How to send an SMS. </p> </li>

<li id="GUID-3F7CD319-B63E-5FF6-8BEB-67FAED970EBB"><p>How to access and display

SMS messages in the inbox, outbox and sent folders. </p> </li>

<li id="GUID-0510D38B-A230-5FD3-BB65-6CA568C2D241"><p>How to delete SMS messages. </p> </li>

</ul> </section>

<section id="GUID-878E4690-1F02-5C15-8B4E-F53E8EA8719D-GENID-1-7-1-16-1-1-4-1-3-1-6-1-3-2"><title>Download</title> <p>Click

on the following link to download the example:<xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-e9c7c7d7-b4a1-4c58-bcbe-37fe6d0f4ce0.zip" scope="external"> smsexample.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-e9c7c7d7-b4a1-4c58-bcbe-37fe6d0f4ce0.html" scope="peer">browse</xref> to view the example code.</p> </section>

<section><title>Class Summary</title><p><xref href="GUID-2DA04D96-F0AD-3FDC-9E36-1C27D889AF4B.dita"><apiname>CMsvSession</apiname></xref></p><p> <xref href="GUID-85BBE389-81F7-3E2F-A789-446D9BE2CC49.dita"><apiname>CMsvEntry</apiname></xref></p><p> <xref href="GUID-AF724192-6580-3DE3-9287-3A005C0AA932.dita"><apiname>CMsvOperation</apiname></xref></p><p> <xref href="GUID-681B56F3-B3A2-3147-B25A-FD69451F4A1D.dita"><apiname>CMsvServerEntry</apiname></xref></p><p> <xref href="GUID-A9FE5C23-4F39-345E-873B-682D9807BAA0.dita"><apiname>CSmsSettings</apiname></xref></p><p> <xref href="GUID-790D9BA9-2FB7-3073-AF2F-FFD049C3FD3D.dita"><apiname>CSmsHeader</apiname></xref></p><p> <xref href="GUID-6BC8851B-D913-3CE5-B343-5163661E8AD5.dita"><apiname>CMsvEntrySelection</apiname></xref></p><p> <xref href="GUID-8CB90FA2-A6CF-3FA2-81FF-7D22EFD9C2CE.dita"><apiname>CMsvStore</apiname></xref></p><p> <xref href="GUID-4181374F-8545-3AF0-8932-A73138296FD1.dita"><apiname>CSsmCommandListResourceReader</apiname></xref></p><p> <xref href="GUID-B36289AC-769F-3A83-BADB-AE0568E97581.dita"><apiname>MMsvEntryObserver</apiname></xref></p><p> <xref href="GUID-BDE23754-4536-3AF7-8549-3B953F51167C.dita"><apiname>MMsvSessionObserver</apiname></xref></p></section>

<section id="GUID-F706F06F-EAD0-5028-8875-C56E8C68B307"><title>Design and

implementation</title> <p>An SMS account is created with a user-specified

service center name and number. Then a message is composed by the user and

sent to the user-specified recipient. </p> </section>

<section id="GUID-2B5D9B09-1ACF-52E5-9FDF-FF6B03096162"><title>Building and

configuring</title> <ul>

<li id="GUID-FD731628-CA35-59F5-ABEB-9F6FC097965B"><p>You can build the example

from your IDE or the command line. </p> <p>If you use an IDE, import the <filepath>bld.inf</filepath> file

of the example into your IDE, and use the build command of the IDE. </p> <p>If

you use the command line, open a command prompt, and set the current directory

to the source code directory of the example. You can then build the example

with the SBSv1 build tools with the following commands: </p> <p><userinput>bldmake

bldfiles</userinput> </p> <p><userinput>abld build</userinput> </p> <p><xref href="GUID-793A5EF9-CC16-5EEB-9011-6431EA76EB15.dita">How to use bldmake</xref> and <xref href="GUID-B6B54E07-3B34-5D5C-8815-93383FA8FB4B.dita">How to use abld</xref> describe

how to use the SBSv1 build tools. </p> </li>

<li id="GUID-DDDF0872-174C-5C68-9068-282EE28B648D"><p>For the emulator, the

example builds an executable called <filepath>smsexample.exe</filepath> in

the <filepath>epoc32\release\winscw\&lt;udeb or                 urel&gt;\</filepath> folder. </p> </li>

</ul> </section>

</refbody><related-links>

<link href="GUID-F2D86E40-279A-5B48-B91F-922803FEF5DE.dita"><linktext>SMS MTM Overview</linktext>

</link>

</related-links></reference>