<?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-0422EDC4-E17C-5E58-BB37-03CCA79ED3E9" xml:lang="en"><title>How

to Wait for a Given Time Period</title><shortdesc>Explains how to use timers to suspend a thread for a given time

period.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>Once the timer has been created and initialised, a request can be set up.</p>

<ul>

<li id="GUID-252BD68A-05F6-57D0-98E1-4BE2B0B7D2D6"><p>start the timer to complete

after a set period by calling <codeph>After()</codeph>, passing the required

period in microseconds</p> </li>

<li id="GUID-7D5F4F30-6AD5-5532-A9BE-015EE4632842"><p>call <codeph>User::WaitForRequest()</codeph> to

wait for completion</p> </li>

</ul>

<p>In the following example, the thread is suspended for a 1 second. <codeph>timerStatus</codeph> is

a <codeph>TRequestStatus</codeph>.</p>

<codeblock id="GUID-4F3CC22C-220D-5B29-8335-2757C47C8763" xml:space="preserve">timer.After(timerStatus,1000000);

User::WaitForRequest(timerStatus); 

</codeblock>

</conbody></concept>