<?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-8B3AB631-AD3F-591A-9DD8-7A9853A99B07" xml:lang="en"><title>Application
User Tutorial</title><shortdesc>This topic describes the steps for applications to use the Domain
Manager.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>Applications interface with the domain manager through the <xref href="GUID-26767FE7-3AF2-3E21-9965-915855B7AB55.dita"><apiname>RDmDomain</apiname></xref> class.
An application joins a domain by calling <codeph>Connect()</codeph>, which
also establishes a session with the domain manager. Once it has joined a domain,
an application can: </p>
<ul>
<li id="GUID-C7B39A32-98C9-5683-9786-55B15B756E0C"><p>request that it be notified
when the power state changes, by calling <codeph>RequestTransitionNotification()</codeph>. </p> </li>
<li id="GUID-ABD3A7F3-697C-5392-B41D-BFEE5DF12B06"><p>cancel an outstanding
request to be notified of power state changes, by calling <codeph>CancelTransitionNotification()</codeph>. </p> </li>
<li id="GUID-8A37C03C-0230-5117-A652-25894197E2EA"><p>get its current domain
power state, by calling <codeph>GetPowerState()</codeph>, usually as a result
of being notified </p> </li>
</ul>
<p>Applications always acknowledge the last observed domain state by calling <codeph>AcknowledgeLastState()</codeph>. </p>
<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>
</conbody></concept>