/*
* ============================================================================
*  Name         : SimLockDataHandlingDelegate.h     
*  Part of      : Sim Lock UI Application
*  Description  : Handles reading and writing of Sim Lock data including
                  unlocking the Sim Lock.
*  Version      : 
*  
* Copyright (c) 2005-2010 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:   Build info file for Ado domain appinstall 
* ============================================================================
*/

#ifndef SIMLOCKDATAHANDLINGDELEGATE_H
#define SIMLOCKDATAHANDLINGDELEGATE_H

// System Includes
#include <e32base.h>

// Forward Declarations
class RMmCustomAPI;
struct TSimPathStr;
struct TSimLockHeadStr;
class CActiveSchedulerWait;
class TIsiReceiveC;
class CPeriodic;

/**
 *  CSimLockDataHandlingDelegate
 *
 *  Delegate class to handle communication with lower layers of S60 and Symbian,
 *  and also the native( ISA ) layer.
 *
 *  @lib euser.lib
 *  @lib iscapi.lib
 *  @lib isimessage.lib
 *  @lib etel.lib
 *  @lib etelmm.lib
 *  @lib customapi.lib
 */
class CSimLockDataHandlingDelegate : public CActive
    {
public: // Public Constructor / Destructor

    /**
     * Two-phased constructor
     *
     */
    static CSimLockDataHandlingDelegate* NewL( RMmCustomAPI& aCustomAPI );

    /**
     * Destructor
     *
     */
    virtual ~CSimLockDataHandlingDelegate();

public: // Public API

     /**
      * Open the Sim Lock( type 1 ) given a passcode.
      *
      * @param aPassword TDesC of the password to open lock
      * @return Indicates the result of the Sim Lock open attempt
      */
    TInt OpenSimLock( const TDesC& aPassword );

     /**
      * Determine if the Sim Lock is open.
      *
      * @return Indicates if Sim Lock is open
      */
    TBool IsSimLockOpen() const;


private: // Private Constructors

     /**
      * C++ constructor.
      *
      * @param aCustomAPI ETel custom API object
      */
    CSimLockDataHandlingDelegate( RMmCustomAPI& aCustomAPI );

     /**
      * Symbian OS default constructor.
      */
    void ConstructL();


private: // From CActive

    /**
     * Active object run method
     * @see CActive
     */
    virtual void RunL();

    /**
     * Active object cancel method
     * @see CActive
     */
    virtual void DoCancel();
    
private: // Local Member API
       
    /**
     * CPeriodic Callback function for elapsed timer
     *
     * @param aUnused requred for interface
     * @return required but unused
     */
    static TInt TimerElapsed(TAny* aUnused);

    /**
     * Pause execution and allow active scheduler to run until the current outstanding
     * request complets
     *
     */
    void CompleteRequestWithTimeout();

private:    // Member Data
    /**
     * Indicates if the Sim Lock is open per the last read from the Sim Lock
     * server.
     */
    TBool iLockIsOpen;

    /**
     * Handle to ETel MultiMode Custom API server
     */
    RMmCustomAPI& iCustomAPI;

    /**
     * Help with asynchronous requests
     */
    CActiveSchedulerWait* iSchedulerWait;

    /**
     * Indicates that Sim Lock data has been read
     */
    TBool iDataHasBeenRead;

    /**
     * Timeout handling timer
     * owns
     */
    CPeriodic* iTimer;

    };

#endif //SIMLOCKDATAHANDLINGDELEGATE_H

// End of File