diff -r 826cea16efd9 -r 13a33d82ad98 videoutils_plat/videoconnutility_api/inc/ipvideo/vcxconnutilengineobserver.h --- /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__