phoneengine/servicehandling/inc/cpeservicehandling.h
changeset 0 5f000ab63145
child 21 92ab7f8d0eab
child 61 41a7f70b3818
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phoneengine/servicehandling/inc/cpeservicehandling.h	Mon Jan 18 20:18:27 2010 +0200
@@ -0,0 +1,147 @@
+/*
+* Copyright (c) 2008 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:  Provides service enabling implementation.
+*
+*/
+
+
+#ifndef C_PESERVICEHANDLING_H
+#define C_PESERVICEHANDLING_H
+
+#include <e32base.h>
+#include <cch.h>
+#include "mpeservicehandling.h"
+
+class  MPEPhoneModelInternal;
+
+/**
+ *  CPEServiceHandling implements the intefaces MPEServiceHandling and 
+ *  thus provides the service enabling imlementation for Phone Engine.
+ *  
+ *  @lib peservicehandling.lib
+ *  @since S60 v5.0
+ */
+NONSHARABLE_CLASS( CPEServiceHandling ): public CBase,
+                                         public MCchServiceStatusObserver,
+                                         public MPEServiceHandling
+    {
+
+	public: // Constructors and destructor
+
+	    /**
+	     * Two-phased constructor.
+	     */
+	    IMPORT_C static CPEServiceHandling* NewL( MPEPhoneModelInternal& aModel );
+
+	    /**
+	     * Two-phased constructor.
+	     */
+	    IMPORT_C static CPEServiceHandling* NewLC( MPEPhoneModelInternal& aModel );
+
+	    /**
+	     * Destructors.
+	     */
+	    IMPORT_C virtual ~CPEServiceHandling();
+
+	public: // from MPEServiceHandling
+	
+        /**
+         * From MPEServiceHandling.
+         * Enables service defined by the given identifier.
+         * This function does the service enabling and service status error checking.
+         * If service is enabled successfully, send message 
+         * (EPEMessageServiceEnabled) to PhoneEngine. 
+         * 
+         * @since   S60 5.0
+         * @param   aServiceId      Identifier of the service.
+         */	                                    
+	    void EnableServiceL( TInt aServiceId );
+	   
+        /**
+         * From MPEServiceHandling.
+         * Cancel current service.
+         */ 
+	    void CancelServiceEnabling() const;
+	    
+        /**
+         * From MPEServiceHandling.
+         * Disable service.
+         */ 
+        void DisableService() const;
+    
+    public: // from MCchServiceStatusObserver
+        
+        /**
+         * From MCchServiceStatusObserver.
+         * Signaled when service status or error changes.
+         *
+         * @param   aServiceId      Identifier of the service.
+         * @param   aType           Service type.
+         * @param   aServiceStatus  Service status.
+         */
+        void ServiceStatusChanged( TInt aServiceId, 
+                                   const TCCHSubserviceType aType,
+                                   const TCchServiceStatus& aServiceStatus );
+	private: // Constructors
+
+        /**
+         * C++ default constructor.
+         */
+        CPEServiceHandling( MPEPhoneModelInternal& aModel );
+        
+        /**
+         * By default Symbian 2nd phase constructor is private.
+         */
+        void ConstructL();
+	    
+    private: // functions
+    
+        /**
+         * Enable service, if not already enabled.
+         *
+         * @param  aState       Service state.
+         * @param  aService     Service.
+         * @return Error code.
+         */
+        TInt EnableServiceIfNeeded( const TCCHSubserviceState& aState, 
+                                    CCchService& aService );
+        /**
+        * Sends ServiceHandlingError message to PhoneEngine and saves 
+        * errorcode to member variable.
+        * 
+        * @param  aErrorCode, Cch errorcode.
+        */	    
+        void SendErrorMessage( TInt aErrorCode );
+       
+	private: // data
+	    
+	    /**
+	     * CCH client.
+	     * Own.
+	     */
+	    CCch* iCchClient;
+
+	    /**
+	     * PhoneModel.
+	     * Not own.
+	     */
+	    MPEPhoneModelInternal& iModel;
+	    
+	    /**
+	     * Current service identifier.
+	     */
+	    TInt iCurrentServiceId;
+    };
+
+#endif // C_PESERVICEHANDLING_H