websrv_pub/web_service_connection_api/inc/senserviceconnectioninterfaces.h
changeset 0 62f9d29f7211
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/websrv_pub/web_service_connection_api/inc/senserviceconnectioninterfaces.h	Thu Jan 07 16:19:19 2010 +0200
@@ -0,0 +1,68 @@
+/*
+* Copyright (c) 2002-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:    In case that Service Consumer (owner of SC instance) needs
+*                some special, even properietary interface, it can request
+*                an implementation of such interface by calling
+*                CSenServiceConnection::InterfaceByUid(UID) and acquire
+*                on of the M-class interfaces defined in this file.
+*
+*/
+
+
+
+
+#ifndef M_SEN_SERVICE_CONNNECTION_INTERFACES_H
+#define M_SEN_SERVICE_CONNNECTION_INTERFACES_H
+
+// CONST
+// UIDs for the supported, new *service connection interfaces*:
+const TUid KSenInterfaceUidAlrServiceConnection      = { 0xE760F699 }; // MSenAlrServiceConnection
+
+
+// CLASS DECLARATION
+/**
+ * Callback interface for service consumers
+ */
+    
+class MSenAlrServiceConnection
+    {
+    public: 
+        /**
+        * With this method client can indicate that it wants to start using a new preferred 
+        * connection as a response to PreferredCarrierAvailable() callback.
+        *
+        * @param aUserChoice TRUE(Yes) FALSE (No)
+        * if UserChoice is TRUE then connection will migrated to new carrier
+        * available,         
+        * if UserChoice is FALSE connection will not migrate to new carrier        
+        */
+	    virtual void MigrateToPrefferedCarrierL(TBool &aUserChoice) = 0 ;
+
+        /**
+        * With this method client can indicate that it accepts to use a new preferred 
+        * connection as a response to NewCarrierActive() callback.
+        * 
+        * Earlier the client has received MigrateToPrefferedCarrierL()
+        * callback. Once it has agreed to migrate through NewCarrierAvailable(),
+        * newCarrierActive() callback will be invoked in order
+        * to get acceptance from the application.
+        *
+        * @param aUserChoice TRUE(Yes) FALSE (No)
+        * if UserChoice is TRUE then new Carrier will be accepted
+        * if UserChoice is FALSE connection will not accept the new carrier        
+        */
+	    virtual void NewCarrierAcceptedL(TBool &aUserChoice) = 0 ;		
+    };    
+    
+#endif //  M_SEN_SERVICE_CONNNECTION_INTERFACES_H   
\ No newline at end of file