// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "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:

//

// Description:

//

#ifndef __GSASTATEPOLICYFAIL_H__

#define __GSASTATEPOLICYFAIL_H__

#include <e32base.h>

#include <ssm/ssmstatepolicy.h>

#include <ssm/ssmconditionalcallback.h>

class CSsmCommandListResourceReader;

/**

Fail state policy plug-in for GSA. This is a polymorphic dll.

Implements MSsmStatePolicy to initialize, prepare and return command list using CSsmCommandListResourceReader.

Implements MSsmConditionalCallback to decide whether to include a command in a command list or not.

@internalComponent

@released

@see MSsmStatePolicy

@see MSsmConditionalCallback

*/

NONSHARABLE_CLASS(CGsaStatePolicyFail) : public CBase, public MSsmStatePolicy, public MSsmConditionalCallback

	{

public:

	IMPORT_C static MSsmStatePolicy* NewL();

	//from MSsmStatePolicy

	TResponse TransitionAllowed(const TSsmStateTransition& aRequest, TSsmStateTransition const* aCurrent, TSsmStateTransition const* aQueued, 

							const RMessagePtr2& aMessage);

	void Initialize(TRequestStatus& aStatus);

	void InitializeCancel();

	void PrepareCommandList(TSsmState aState, TInt aReason, TRequestStatus& aStatus);

	void PrepareCommandListCancel();

	CSsmCommandList* CommandList();

	TBool GetNextState(TSsmState aCurrentTransition, TInt aReason, TInt aError, TInt aSeverity, TSsmState& aNextState);

	void Release();

	// from MSsmConditionalCallback

	TBool ConditionalCommandAllowedL(CResourceFile& aResourceFile, TInt aResourceId);

private:

	~CGsaStatePolicyFail();

	CGsaStatePolicyFail();

	void ConstructL();

private:

	CSsmCommandListResourceReader* iCommandListResourceReader;

	RFs iFs;

	// Possible panic codes within Fail policy

	enum TFailPanicCodes

		{

		/**

		 Panic when command list resource reader is NULL

		*/

		EInvalidResourceReader = 1,

		/**

		 Panic when Main state supplied is not 'ESsmFail'

		*/

		EInvalidFailState,

		/**

		 Panic when CLE returns an error executing Fail command list

		*/

		ERestartDevice,

		/**

		 Panic when ConditionalCommandAllowedL is called for a command which hasn't implemented conditional_information

		*/

		EConditionalInfoNotImplemented

		};

	};

#endif	//__GSASTATEPOLICYFAIL_H__