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