/*
* Copyright (c) 2007-2007 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:  For handling interactions betweed UI and CCH.
*
*/



#ifndef C_CSCENGCCHHANDLER_H
#define C_CSCENGCCHHANDLER_H

#include <cch.h>

class MCSCEngCCHObserver;

/**
 * TSupportedSubServices class
 *
 * @lib cscengine.lib
 * @since Series 60 3.2
 */
NONSHARABLE_CLASS ( TSupportedSubServices )
    {
    public:
    
        /**
         * Constructor.
         *
         * @since S60 3.2
         */
        TSupportedSubServices()
            : iVoIP( EFalse ),
            iPresence( EFalse ),
            iIm( EFalse ),
            iVmbx( EFalse )
            {}

    public: // data
        
        /*
         * VoIP
         */
        TBool iVoIP;
    
        /*
         * Presence
         */
        TBool iPresence;
    
        /*
         * Instant Messaging
         */
        TBool iIm;
        
        /*
         * Voice mail box
         */
        TBool iVmbx;
    };


/**
 * An instance of CCSCEngCCHHandler
 * For handling interactions betweed UI and CCH.
 *
 * @lib cscengine.lib
 * @since Series 60 3.2
 */
NONSHARABLE_CLASS( CCSCEngCCHHandler ) : public CBase, 
                                                MCchServiceStatusObserver
    {    
    public:
                
        /**
         * Two-phased constructor.
         */ 
        IMPORT_C static CCSCEngCCHHandler* NewL( 
            MCSCEngCCHObserver& aObserver );


        /**
         * Destructor.
         */
        virtual ~CCSCEngCCHHandler();
        
        
        /**
         * Disable service
         *
         * @since S60 v5.0
         * @param aServiceId service id
         * @return Error code.
         */
        IMPORT_C TInt DisableService( TInt aServiceId );
        
                
        /**
         * Get supported subservices
         *
         * @since S60 v5.0
         * @param aServiceId service id
         * @param aSupSubServices supported subservices
         */
        IMPORT_C void SupportedSubServicesL( 
                TInt aServiceId, 
                TSupportedSubServices& aSupSubservices );
        
        
        /**
         * Get cch connection parameter (RBuf)
         *
         * @since S60 v5.0
         * @param aServiceId service id
         * @param aConnParam cch connection parameter
         * @param aConnParamValue connection parameter value
         * @return Error code.
         */
        IMPORT_C TInt GetConnectionParameter( 
            TInt aServiceId, 
            TCchConnectionParameter aConnParam,
            RBuf& aConnParamValue );
        
        
        /**
         * Get cch connection parameter( TInt )
         *
         * @since S60 v5.0
         * @param aServiceId service id
         * @param aConnParam cch connection parameter
         * @param aConnParamValue connection parameter value
         * @return Error code.
         */
        IMPORT_C TInt GetConnectionParameter( 
            TInt aServiceId, 
            TCchConnectionParameter aConnParam,
            TInt& aConnParamValue );
        
        
        /**
         * Set cch connection parameter
         *
         * @since S60 v5.0
         * @param aServiceId service id
         * @param aConnParam cch connection parameter
         * @param aConnParamValue connection parameter value
         * @return Error code.
         */
        IMPORT_C TInt SetConnectionParameter( 
            TInt aServiceId, 
            TCchConnectionParameter aConnParam,
            const TDesC& aConnParamValue );
        
        
        /**
         * For checking if service is disabled
         *
         * @since S60 v3.2
         * @param aServiceId service id
         * @return ETrue if service is disabled
         */
        IMPORT_C TBool IsServiceDisabled( TInt aServiceId );
               
        
        /**
         * For checking if service is valid (some subservice(s) is supported)
         *
         * @since S60 v5.0
         * @param aServiceId service id
         * @return ETrue if service is valid
         */
        IMPORT_C TBool IsServiceValidL( TInt aServiceId );
        
    private:

        CCSCEngCCHHandler( 
            MCSCEngCCHObserver& aObserver );

        void ConstructL();
        
        
        /**
         * Returns ETrue if subservice is disabled
         * 
         * @since S60 v5.0
         * @param aServiceId Service id.
         * @param aType Subservice type.
         * @return ETrue if subservice is disabled
         */
        TBool IsDisabled( TInt aServiceId, TCCHSubserviceType aType );
        
        
        // from base class MCchServiceStatusObserver
        
        /**
         *  From MCchServiceStatusObserver
         * 
         * @since S60 v5.0
         * @param aServiceId Service id.
         * @param aType Subservice type.
         * @return aServiceStatus service status.
         */
        void ServiceStatusChanged( 
            TInt aServiceId, 
            TCCHSubserviceType aType, 
            const TCchServiceStatus& aServiceStatus );
        
    private:  // data
        
        /**
         * Reference for observer.
         */
        MCSCEngCCHObserver& iObserver;
               
        /**
         * Handle to CCH Client API.
         * Own.
         */
        CCch* iCchClientApi;
        
#ifdef _DEBUG
    friend class UT_CSCEngCchHandler;
#endif 
    };

#endif // C_CSCENGCCHHANDLER_H