<?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 concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-086939FA-D381-5705-BEE6-6DF2D3624849" xml:lang="en"><title>Timers

and Timing Services Example Code</title><shortdesc>This example describes how to use <codeph>RTimer</codeph> functions.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<ul>

<li id="GUID-9D1268CE-9D9F-5B51-A578-772937196CD7"><p> <xref href="GUID-086939FA-D381-5705-BEE6-6DF2D3624849.dita#GUID-086939FA-D381-5705-BEE6-6DF2D3624849/GUID-3205DDD3-D057-56BF-8F64-CF1AFF52619B">BasicTimer: the asynchronous timer</xref> </p> </li>

<li id="GUID-044A87AB-3F8E-575F-9220-6C07FB0BC952"><p> <xref href="GUID-086939FA-D381-5705-BEE6-6DF2D3624849.dita#GUID-086939FA-D381-5705-BEE6-6DF2D3624849/GUID-0554FACD-5075-5C8D-8634-F60D31D1EDB7">Periodic: a periodic timer and a heartbeat timer</xref> </p> </li>

</ul>

<section id="GUID-3205DDD3-D057-56BF-8F64-CF1AFF52619B"><title>BasicTimer:

the asynchronous timer</title> <p><b>Download</b> </p> <p>Click the following

link to download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-0feaa43f-bf66-4a6c-b61b-f768f6524d22.zip" scope="external">BasicTimer.zip</xref>.</p><p>Click the following link to

download additional files: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-4184e6d4-8dbe-4267-b1a3-8737c8bf64ce.zip" scope="external">CommonFramework.zip</xref></p><p>Click <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-0feaa43f-bf66-4a6c-b61b-f768f6524d22.html" scope="peer">browse BasicTimer</xref> to view the example code.</p><p>Click <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-4184e6d4-8dbe-4267-b1a3-8737c8bf64ce.html" scope="peer">browse CommonFramework </xref> to view additional files.</p> <p><b>Description</b> </p> <p>This

example demonstrates the asynchronous timer, <codeph>RTimer</codeph>. The

example does <i>not</i> use active objects. </p><p><b>Class summary</b></p><ul>

<li><p><xref href="GUID-8A423EA2-4264-30C9-9579-0466994E6E88.dita"><apiname>RTimer</apiname></xref> - Asynchronous timer services.</p></li>

<li><p><xref href="GUID-E0B34F3E-D4C4-3232-B8B1-7DB35B454646.dita"><apiname>TRequestStatus</apiname></xref> - Indicates the completion status

of a request made to a service provider.</p></li>

</ul> <p><b>Security issues</b> </p> <p>The example requires no specific capabilities

in order to run - and does not demonstrate any security issues. </p> </section>

<section id="GUID-0554FACD-5075-5C8D-8634-F60D31D1EDB7"><title>Periodic: a

periodic timer and a heartbeat timer</title> <p><b>Download</b> </p> <p>Download

the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-3195c0fc-704f-4fd4-8c99-407f795abc5f.zip" scope="external">Periodic.zip</xref>. </p><p>Download some additional files

required by the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-4184e6d4-8dbe-4267-b1a3-8737c8bf64ce.zip" scope="external">CommonFramework.zip</xref></p><p>View the source code: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-3195c0fc-704f-4fd4-8c99-407f795abc5f.html" scope="peer">browse</xref>. View the additional file: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-4184e6d4-8dbe-4267-b1a3-8737c8bf64ce.html" scope="peer">browse</xref></p> <p><b>Description</b> </p> <p>The example demonstrates

a periodic and a heartbeat timer and shows the differences between them. </p><p><b>Class

summary</b></p><ul>

<li><p><xref href="GUID-8D6075C7-A340-36A6-A152-0E3E76070311.dita"><apiname>CHeartBeat</apiname></xref></p></li>

<li><p><xref href="GUID-3CECC9FC-58C1-3117-AAF2-FDF88341F56F.dita"><apiname>CPeriodic</apiname></xref> - Periodic timer active object.</p></li>

</ul> <p><b>Security issues</b> </p> <p>The example requires no specific capabilities

in order to run - and does not demonstrate any security issues. </p> </section>