videoutils_plat/videoconnutility_api/inc/ipvideo/vcxconnutilengineobserver.h
branchRCL_3
changeset 48 13a33d82ad98
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/videoutils_plat/videoconnutility_api/inc/ipvideo/vcxconnutilengineobserver.h	Wed Sep 01 12:20:37 2010 +0100
@@ -0,0 +1,79 @@
+/*
+* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of the License "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:    Interface for network event handling*
+*/
+
+
+#ifndef _M_CVCX_CONUTILENGINEOBS_H__
+#define _M_CVCX_CONUTILENGINEOBS_H__
+
+// Deprecation warning
+#warning This header file has been deprecated. Will be removed in one of the next SDK releases.
+
+
+// CLASS DECLARATION
+/**
+* Interface for the clients of vcxconnectionutility to receive and react
+* for iap changes and roaming. 
+* It is not required for a client to implement this interface. In that case
+* vcxconnectionutility always excepts client to allow roaming.
+* 
+*/
+
+class MConnUtilEngineObserver
+
+    {
+    public:
+
+         /**
+         * This method is called by the vcxconnectionutility when 
+         * it has received a notification about the availability of
+         * "better" iaps in the network. This can happen  
+         * when WLAN defined in the corresponding destination becomes
+         * available or when WLAN carrier is lost and there is a defined
+         * 3G/gprs iap (or another available WLAN) in the destination
+         * being used.
+         *
+         * Client does not have to accept the changing of the iap. If the client 
+         * returns EFalse notifying it does not want to roam, then the 
+         * iap is not changed.
+         *
+         * This however can result in disconnecting, if the old iap is 
+         * no longer available, as happens when WLAN carrier is lost
+         *
+         * @return TBool  ETrue: roaming accepted, EFalse: Roaming not accepted
+         *
+         */
+        virtual TBool RequestIsRoamingAllowedL() = 0;
+        
+        /**
+         * This method is called by the vcxconnectionutility when 
+         * there have been some changes in the iap currently using:
+         * 
+         * Connection lost: this happens when for example WLAN carrier 
+         * is lost and there is no other iap to use or when the corresponding
+         * connection is closed by some other application.
+         *
+         * Iap change by the roaming: if the client has accepted roaming,
+         * vcxconnectionutility notifies about new iap is ready to use
+         *
+         * When client is being called by this method, it can request an
+         * iap id by calling CVcxConnectionUtility::GetIap-
+         *
+         *
+         */
+        virtual void  IapChangedL() = 0;
+    };
+
+#endif // _M_CVCX_CONUTILENGINEOBS_H__