--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/videoutils_plat/videoconnutility_api/inc/ipvideo/vcxconnutilengineobserver.h Thu Dec 17 09:14:38 2009 +0200
@@ -0,0 +1,76 @@
+/*
+* 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__
+
+
+// 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__