<?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 task
  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="GUID-BBA7D3E2-1766-53CA-8D58-4F0B3BAA4873" xml:lang="en"><title>Registering
for Shutdown Notification</title><shortdesc>This document explains how to register for shutdown notification
for a component. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
<prereq><p>Before you start, you must know: </p> <ul>
<li id="GUID-5B8F2E24-2E7C-569E-9603-2775788DD9F3"><p>the APIs for components
that want to be system state aware. </p> </li>
<li id="GUID-E7336F6D-EDB1-5EB2-A2FD-9D28468EEC1C"><p>that each state aware
component must connect to the appropriate domain ID. </p> </li>
</ul> </prereq>
<context><p>Register a component or an application for shutdown notification
through <xref href="GUID-89C25B0F-DB76-30D5-A4D6-0C12922194E4.dita"><apiname>RSsmStateAwareSession</apiname></xref> if they need to do save critical
or non-critical data and perform clean-up tasks at the time of shutdown. </p> <p>For
example, a component or an application can free all resources or can close
any connection with the servers to make the shutdown graceful. The shutdown
sequence will commence once all the components acknowledge the notification
they have received. </p><p>Follow the steps given below to register for shutdown
notification:</p></context>
<steps id="GUID-70BB5BD2-EFB2-5E9E-BFE4-B57B9E6FB49B">
<step id="GUID-EA0AA697-4409-5587-BBC7-8E18EF7E0B6D"><cmd/>
<info>Create a class which is derived from <xref href="GUID-067293BF-B28C-3CEC-92F4-1351A795EA7F.dita"><apiname>CActive</apiname></xref>  </info>
<info>The following code snippet illustrates how to create a class from <xref href="GUID-067293BF-B28C-3CEC-92F4-1351A795EA7F.dita"><apiname>CActive</apiname></xref>: </info>
<stepxmp><codeblock id="GUID-C84D1F72-0FFE-5E2E-B34B-1325E905030C" xml:space="preserve">
class CExample : public CActive
{
    public:
          static CExample* NewL();
          ~CExample();

          private:
              //from CActive
              void RunL();
              void DoCancel();
          private:
              void ConstructL();
          private:
              RSsmStateAwareSession iStateAwareSession;
              //A state aware component, which can be used to provide APIs for components that want to be system state aware.
};
</codeblock> </stepxmp>
</step>
<step id="GUID-5D5E947F-A834-598C-9D13-D0D8C50F9B91"><cmd/>
<info>Connect the session and register for notification. </info>
<info>The following code snippet illustrates how to connect the session and
register for notification: </info>
<stepxmp><codeblock id="GUID-99CB04C9-838D-57A5-9154-39F739178FFC" xml:space="preserve">
CExample* CExample::NewL()
{
    CExample* self = new( ELeave ) CExample();
          CleanupStack::PushL( self );
          self-&gt;ConstructL();
          CleanupStack::Pop( self );
          return self;
}
CExample:: CExample()
CActive( CActive::EPriorityStandard )
{
    CActiveScheduler::Add( this );
}
void CExample::ConstructL()
{
    // Each state aware component must connect to the appropriate domain ID.
    //Example, this component is high up in the domain hierarchy ( in the UI Frameworks domain ).
    User::LeaveIfError( iStateAwareSession.Connect ( KUIFramework3 ));
          iStateAwareSession.RequestStateNotification( iStatus );
          SetActive();
}</codeblock> </stepxmp>
</step>
</steps>
<result><p>The component is registered for shutdown notification. </p> </result>
<postreq><p>After registering for shutdown notification, the user needs to
know how the component handles and acknowledge the shutdown notification. </p> </postreq>
</taskbody><related-links>
<link href="GUID-833BF27D-B288-506A-B545-E748C9FE7AEA.dita"><linktext>Making a
Component Shutdown Aware</linktext></link>
</related-links></task>