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

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

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

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

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

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

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

    12 <concept id="GUID-8B3AB631-AD3F-591A-9DD8-7A9853A99B07" xml:lang="en"><title>Application

    13 User Tutorial</title><shortdesc>This topic describes the steps for applications to use the Domain

    14 Manager.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p>Applications interface with the domain manager through the <xref href="GUID-26767FE7-3AF2-3E21-9965-915855B7AB55.dita"><apiname>RDmDomain</apiname></xref> class.

    16 An application joins a domain by calling <codeph>Connect()</codeph>, which

    17 also establishes a session with the domain manager. Once it has joined a domain,

    18 an application can: </p>

    19 <ul>

    20 <li id="GUID-C7B39A32-98C9-5683-9786-55B15B756E0C"><p>request that it be notified

    21 when the power state changes, by calling <codeph>RequestTransitionNotification()</codeph>. </p> </li>

    22 <li id="GUID-ABD3A7F3-697C-5392-B41D-BFEE5DF12B06"><p>cancel an outstanding

    23 request to be notified of power state changes, by calling <codeph>CancelTransitionNotification()</codeph>. </p> </li>

    24 <li id="GUID-8A37C03C-0230-5117-A652-25894197E2EA"><p>get its current domain

    25 power state, by calling <codeph>GetPowerState()</codeph>, usually as a result

    26 of being notified </p> </li>

    27 </ul>

    28 <p>Applications always acknowledge the last observed domain state by calling <codeph>AcknowledgeLastState()</codeph>. </p>

    29 <section id="GUID-0F7307AC-D121-479C-9B17-E86E99F7A29D"><title>See also</title> <p> <xref href="GUID-CC79A9D5-FA16-5503-BEBB-182DB599F006.dita">Concepts</xref> </p> </section>

    30 </conbody></concept>