// Copyright (c) 1997-2009 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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

 // which accompanies this distribution, and is available

 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

 //

 // Initial Contributors:

 // Nokia Corporation - initial contribution.

 //

 // Contributors:

 //

 // Description:

 //

 #if !defined(SAVENOTF_H)

 #define SAVENOTF_H

 #include <e32std.h>

 #include <e32base.h>

 /**

 This interface has to be implemented by all clients, which want to be notified about events

 like shutdown/low memory. When this happens the implementation of MSaveObserver::SaveL() will

 be called.

 @see CSaveNotifier

 @publishedPartner

 @released

 */

 class MSaveObserver

 	{

 public:

 	enum TSaveType

 		{

 		ESaveNone,

 		ESaveData,

 		ESaveAll,

 		ESaveQuick,

 		EReleaseRAM,

 		EReleaseDisk,

 		};

 public:

 	virtual void SaveL(TSaveType aSaveType)=0;

 	};

 /**

 This class describes a client side session object, handling requests

 to the shutdown server.

 @internalComponent

 */

 class RSaveSession : public RSessionBase

 	{

 public:

 	TInt ConnectL();

 	void NotifySave(TRequestStatus& aStatus);

 	void NotifySaveCancel();

     TInt SwitchOff(MSaveObserver::TSaveType aAction, TBool aPowerOff);

     TInt ServerPowerState(TBool& aPowerOff);

 private:

 	TInt StartServerL();

 	};

 /**

 This class describes an object, which can be used by the clients, which want to be notified

 about events like powerdown/low memory. The clients have to implement MSaveObserver interface.

 When a particular event happens, the client's implementation of MSaveObserver::SaveL() will

 be called.

 @see MSaveObserver

 @publishedPartner

 @released 

 */

 class CSaveNotifier : public CActive

 	{

     friend class CPowerdownClient;//test class

     friend class CPowerdownClient2;//test class

 public:

 	IMPORT_C static CSaveNotifier* NewL(MSaveObserver& aObserver);

 	IMPORT_C ~CSaveNotifier();

 	IMPORT_C void DelayRequeue();

 	IMPORT_C void Queue();

 	IMPORT_C void HandleError(TInt /*aError*/);

 private:

 	IMPORT_C TInt SwitchOff(MSaveObserver::TSaveType aAction, TBool aPowerOff);

 	IMPORT_C TInt ServerPowerState(TBool& aPowerOff);

 	inline CSaveNotifier(MSaveObserver& aObserver);

 	void ConstructL();

 	void Start();

 private: // from CActive

 	void DoCancel();

 	void RunL();

 private:

 	RSaveSession iSaveSession;

 	MSaveObserver& iSaveObserver;

 	TUint iFlags;

 	};

 #endif