1.1 --- a/epoc32/include/comms-infras/cs_mobility_apiext.h Wed Mar 31 12:27:01 2010 +0100
1.2 +++ b/epoc32/include/comms-infras/cs_mobility_apiext.h Wed Mar 31 12:33:34 2010 +0100
1.3 @@ -1,9 +1,9 @@
1.4 // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
1.5 // All rights reserved.
1.6 // This component and the accompanying materials are made available
1.7 -// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
1.8 +// under the terms of "Eclipse Public License v1.0"
1.9 // which accompanies this distribution, and is available
1.10 -// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
1.11 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.12 //
1.13 // Initial Contributors:
1.14 // Nokia Corporation - initial contribution.
1.15 @@ -11,100 +11,15 @@
1.16 // Contributors:
1.17 //
1.18 // Description:
1.19 +// This file is provided for source compatibility only.
1.20 +//
1.21 //
1.22
1.23 -
1.24 -
1.25 /**
1.26 @file
1.27 @publishedAll
1.28 - @released
1.29 + @deprecated use comms-infras/es_mobility_apiext.h
1.30 */
1.31
1.32 -#ifndef CS_MOBILITY_APIEXT_H
1.33 -#define CS_MOBILITY_APIEXT_H
1.34 +#include "./comms-infras/es_mobility_apiext.h"
1.35
1.36 -#include <es_sock.h>
1.37 -#include <comms-infras/cs_api_ext.h> //For RCommsApiExtension
1.38 -#include <comms-infras/api_ext_msg.h> //For CCommsApiExtensionMsg manipulation, used only with RCommsMobilityApiExt
1.39 -
1.40 -class RCommsMobilityApiExt : public RCommsApiExtension<EMobilityApiExt>
1.41 -/**
1.42 -Comms Mobility API extension for client not running an Active Scheduler.
1.43 -
1.44 -This class can actually be used by any client, one running an Active Scheduler
1.45 -and one that is not. However, if the Active Scheduler is present,
1.46 -it is recommended to use CActiveCommsMobilityApiExt which is much simpler.
1.47 -
1.48 -@see CActiveCommsMobilityApiExt
1.49 -
1.50 -@internalTechnology
1.51 -@released
1.52 -*/
1.53 - {
1.54 -public:
1.55 - IMPORT_C explicit RCommsMobilityApiExt();
1.56 - IMPORT_C void Close();
1.57 -
1.58 - IMPORT_C void RegisterForMobilityNotification(TDes8& aResponseEventBuf, TRequestStatus& aStatus);
1.59 - IMPORT_C void CancelMobilityNotification();
1.60 -
1.61 - IMPORT_C void MigrateToPreferredCarrier();
1.62 - IMPORT_C void IgnorePreferredCarrier();
1.63 - IMPORT_C void NewCarrierAccepted();
1.64 - IMPORT_C void NewCarrierRejected();
1.65 - };
1.66 -
1.67 -class MMobilityProtocolResp
1.68 -/**
1.69 -Comms Mobility API extension protocol.
1.70 -Used with CActiveCommsMobilityApiExt to reqister for mobility response messages.
1.71 -
1.72 -@publishedAll
1.73 -@released
1.74 -*/
1.75 - {
1.76 -public:
1.77 - virtual void PreferredCarrierAvailable(TAccessPointInfo aOldAP, TAccessPointInfo aNewAP, TBool aIsUpgrade, TBool aIsSeamless) = 0;
1.78 - virtual void NewCarrierActive(TAccessPointInfo aNewAP, TBool aIsSeamless) = 0;
1.79 - virtual void Error(TInt aError) = 0;
1.80 - };
1.81 -
1.82 -class CActiveCommsMobilityApiExt : public CActive
1.83 -/**
1.84 -Comms Mobility API extension for client running an Active Scheduler.. Whenever an Active
1.85 -Scheduler is present, this API is recommended over RCommsMobilityApiExt because of its simplicity.
1.86 -
1.87 -With few important exceptions, CActiveCommsMobilityApiExt exports very similar APIs to RCommsMobilityApiExt
1.88 -
1.89 -@see RCommsMobilityApiExt
1.90 -
1.91 -@publishedAll
1.92 -@released
1.93 -*/
1.94 - {
1.95 -public:
1.96 - IMPORT_C static CActiveCommsMobilityApiExt* NewL(RCommsSubSession& aExtensionProvider,MMobilityProtocolResp& aProtocol);
1.97 - IMPORT_C ~CActiveCommsMobilityApiExt();
1.98 -
1.99 - IMPORT_C void MigrateToPreferredCarrier();
1.100 - IMPORT_C void IgnorePreferredCarrier();
1.101 - IMPORT_C void NewCarrierAccepted();
1.102 - IMPORT_C void NewCarrierRejected();
1.103 -
1.104 -protected:
1.105 - void ConstructL(RCommsSubSession& aExtensionProvider);
1.106 - explicit CActiveCommsMobilityApiExt(MMobilityProtocolResp& aProtocol);
1.107 -
1.108 -private:
1.109 - void DoCancel();
1.110 - void RunL();
1.111 - TInt RunError(TInt aError);
1.112 -
1.113 -private:
1.114 - MMobilityProtocolResp& iProtocol;
1.115 - RCommsMobilityApiExt iExtApi;
1.116 - RBuf8 iResponseBuf;
1.117 - };
1.118 -
1.119 -#endif // CS_MOBILITY_APIEXT_H