/*
* Copyright (c) 2002-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: 
*
*     This class provides UI for RFS activation. The process can be canceled
*     from any active object's RunL() while the RFS queries are on the screen.
*     (By deleting the object or using Cancel() method)
*
*/


#ifndef RFS_HANDLER_H
#define RFS_HANDLER_H

//  INCLUDES

#include <e32std.h>
#include <etel.h>
#include <etelmm.h>

// CONSTANTS

// Rfs level

enum TRfsType
    {
    ERfsNormal  = 0,
    ERfsDeep    = 1
    };

// FORWARD DECLARATIONS

class CAknQueryDialog;
class CAknInformationNote;
class CEikonEnv;
class CSecurityHandler;
class CRfsSecurityHandler;
class CRfsPdpObserver;

// CLASS DECLARATION

/**
*  This class provides a method to activate the rfs process including all UI.
*  (notes etc.)
*/
class CRfsHandler : public CBase
    {
    public:  // Constructors and destructor

        /**
        * Constructor doesn't allocate any resources.
        */
        IMPORT_C CRfsHandler();

        /**
        * Destructor also calls Cancel()
        */
        IMPORT_C ~CRfsHandler();

    public: // New functions

        /**
        * Activates the RFS process. Returns when the user either canceled RFS
        * or confirmed it, in which case the phone will be rebooted.
        *
        * While the queries are on the screen, the active scheduler is running,
        * allowing the operation to be canceled.
        *
        * In RFS process:
        *
        * Security code is asked and confirmation query is shown
        * (order depending on the parameter aAskSecurityCodeFirst).
        * If the correct security code is entered and the confirmation query
        * approved, the phone is rebooted with RFS reason.
        *
        * @param aMode - rfs level
        * @param aAskSecurityCodeFirst - If true, the security code is asked
        * first and the confirmation query shown after that. If false,
        * confirmation query is shown first.
        *
        * Method leaves if the initialisations can't be done (problems in ETel
        * connection or memory allocations)
        */
        IMPORT_C void ActivateRfsL( TRfsType aMode, 
                                    TBool aAskSecurityCodeFirst = EFalse );


        /**
        * Cancels the RFS process.
        * Deletes the RFS notes/queries from the screen.
        *
        * This can be called from an active object's RunL() while
        * ActivateRfsL() is being executed.
        *
        * Multiple cancel calls have no effect.
        */
        IMPORT_C void Cancel();

    private:    // new functions

        /**
        * Loads the resources needed for the confirmation query.
        *
        * @return resource file offset
        */
        void LoadResourceL();

        /**
        * Sets the default language code in HAL.
        * This must be done before rebooting the phone for deep level RFS.
        */
        void SetDefaultLanguage() const;

        /**
        * Shows the RFS confirmation query.
        * 
        * @param aThisDestroyed  ETrue, if the RFS handler object was destroyed, otherwise EFalse.          
        * @param aType           Represents RFS reason Normal or Deep.              
        * @return                ETrue, if user selected 'YES' as an option at the confirmation query dialog
        *                        otherwise EFalse.
        * @leave                 leaves with one of the system wide error.
        */
        TBool AskConfirmationL( const TBool& aThisDestroyed, TRfsType aType );

        /**
        * Cleans up the mess, by calling Cancel().
        */
        static void DoCleanup( TAny* aAny );

        /**
        * Checks for calls or data sessions and warns if active
        *
        * @return ETrue if there are active connection, EFalse otherwise
        */
        TBool CheckConnectionsL();

        /**
        * Checks if 2G or 3G connection is active
        *
        * @return ETrue if 2G is active or EFalse if 3G
        */
        TBool IsGprs() const;

    private:    // Data

        // resource file
        TInt iResourceFileOffset;

        // UIKON environment
        CEikonEnv* iEnv;

        // flags
        TInt iFlags;

        // confirmation query
        CAknQueryDialog* iQuery;

        // for security code query when using SecUI
        CSecurityHandler* iSecurityHandler;

        RTelServer iTelServer;
        RMobilePhone iPhone;

        // pointer to a stack variable in ActivateRfsL()
        TBool* iDestroyedPtr;

        // for security code query when using Security Engine
        CRfsSecurityHandler* iSecHandler;

        TBool iAlwaysOnlineConnectionClosed;

    private:    // friend classes

        friend class CRfsQueryDialog;
    };

#endif          // RFS_HANDLER_H   
            
// End of File